AgentSkillsCN

phase-workflow-runner

运行完整的阶段工作流：审核现有工作，填补空白，运行测试，验证验收条件，并报告下一阶段就绪情况。当用户要求运行或完成项目阶段时使用此方法。

SKILL.md
--- frontmatter
name: phase-workflow-runner
description: Runs a complete phase workflow: audit existing work, fill gaps, run tests, verify acceptance criteria, and report readiness for next phase. Use when user asks to run or complete a project phase.

Phase Workflow Runner

This skill executes a deterministic, repeatable phase workflow.

Core Principles

  • •Never overwrite existing working code
  • •Never redo completed tasks
  • •Always audit before action
  • •Tests define correctness
  • •Phase completion requires verification

Workflow Steps (MANDATORY)

1. Phase Audit

  • •Inspect project structure
  • •Read relevant spec and tasks files
  • •Identify:
    • •Completed items
    • •Missing files
    • •Failing or absent tests
    • •Partial implementations

Produce a concise audit report before proceeding.

2. Gap Filling

Only after audit:

  • •Create missing source files
  • •Create missing test files (RED)
  • •Implement minimal code to pass tests (GREEN)
  • •Refactor if required

Rules:

  • •Do not modify completed, passing code
  • •Do not remove existing functionality

3. Execution & Verification

  • •Run full test suite
  • •Perform manual smoke checks if CLI/project requires
  • •Verify acceptance criteria from spec.md

4. Documentation Update

  • •Update tasks.md checkboxes
  • •Mark checkpoints complete
  • •Add short completion summary

5. Completion Gate

If all criteria pass:

  • •Declare phase COMPLETE
  • •Ask user: “Phase X complete. Proceed to Phase X+1?”

If not:

  • •Report blockers and stop

Safety Rules

  • •Never hallucinate missing work
  • •Never assume tests exist
  • •Never skip audit
  • •Never continue if tests fail

Output Format

Always output:

  1. •Audit Summary
  2. •Actions Taken
  3. •Test Results
  4. •Acceptance Criteria Status
  5. •Next Step Recommendation