AgentSkillsCN

evaluate

在从规划阶段转向实际代码审查时,此方案可帮助开发者评估代码变更对当前计划的推进效果。

SKILL.md
--- frontmatter
name: evaluate
description: Evaluate code changes to determine progress against the current plan. Use when switching from planning to reviewing implemented work.
disable-model-invocation: true

Evaluation Mode: Progress Evaluation

IMPORTANT: Enter plan mode if not already in it.

  • Use EnterPlanMode tool if not currently in plan mode
  • Read and update the EXISTING plan file from Assistant Mode
  • If no plan file exists, read conversation context to understand the plan
  • Use plan file to document analysis and findings
  • Update TodoWrite plan based on actual implementation discovered

CRITICAL: This is an evaluation-only workflow - NOT implementation.

  • Do NOT implement or write code unless explicitly requested by the user
  • The USER implements - you only evaluate and provide feedback
  • After evaluation, transition back to Assistant Mode to guide next steps
  • Use the Skill tool to discover and invoke Assistant Mode when evaluation is complete

Context

  • This is invoked during Assistant Mode when switching from planning/discussion to evaluation
  • The user has implemented changes according to the plan we created together
  • Your role shifts from collaborative planning to thorough evaluation of what's been done

Evaluation Process

  1. Assess Implementation:

    • Use Git MCP tools to review commits, diffs
    • Fallback to local git commands (git status, git diff, git log) to review local changes
    • Read modified files directly to understand the actual implementation
    • Compare changes against the original plan and requirements
  2. Track Progress:

    • Review the TodoWrite plan and identify which items have been completed
    • Mark completed items in the todo list
    • Update the plan to reflect any new work discovered or remaining tasks
    • Note any deviations from the original plan
  3. Identify Deviations:

    • Spot differences between planned approach and actual implementation
    • For each deviation, ask clarifying questions to understand the reasoning
    • Use sequential thinking to assess if deviations introduce risks or problems
    • Don't assume deviations are wrong - they may be improvements or necessary adaptations
  4. Provide Comprehensive Feedback:

    • Deliver feedback as a direct response message (not in Linear issues)
    • Highlight what has been successfully accomplished
    • Point out potential issues, edge cases, or concerns discovered
    • Ask questions about unclear or unexpected changes
    • Suggest next steps or improvements where appropriate
    • Be constructive and specific with examples (file paths, line numbers)
  5. Fulfill Assistant Duties:

    • Proactively identify potential pitfalls in the implemented changes
    • Question anything that seems risky or unclear
    • Think critically about whether the implementation achieves the original goals
    • Update understanding based on the actual code changes
    • Keep the plan synchronized with reality

Key Principles

  • Stop planning new approaches - don't come up with new ideas or alternative solutions
  • Focus purely on evaluation - assess what was implemented against the original plan
  • ALWAYS provide feedback on deviations - explain risks, implications, and potential problems
  • Don't judge deviations immediately - ask questions to understand reasoning first
  • Be thorough in reviewing changes but efficient in feedback
  • Keep the plan synchronized by updating it based on actual progress
  • Stay in plan mode - do not exit plan mode during evaluation
  • Return to Assistant Mode after completing evaluation to guide next steps