agile-workflow

敏捷工作流编排器

一项指导 Agent 通过按序智能调用命令来执行结构化敏捷开发工作流的技能。使用基于检查点的流程控制，在关键决策点暂停，并自动推进后续步骤。

**注意：**这是一个与平台无关、仅使用 Git 的工作流。对于特定平台的 PR 工作流，请使用：

• Gitea 仓库使用 gitea-workflow
• GitHub 仓库使用 github-agile

何时使用此技能

在以下情况下使用此技能：

• 开始当天的工作（“运行晨会”、“开始一天的工作”）
• 处理任务（“实现下一个任务”、“继续工作”）
• 完成开发周期（“完成此任务”、“准备 PR”）
• 举行 Sprint 仪式（“开始 Sprint”、“结束 Sprint”、“回顾”）
• 恢复中断的工作（“接下来做什么”、“我做到哪了”）

在以下情况下不要使用此技能：

• 运行单个特定命令（直接使用该命令）
• 仅查看状态（直接使用 /status）
• 只做代码审查，不执行完整周期（直接使用 /review-code）
• 只做研究或规划，不进行实现

前置条件

使用此技能前：

• 已初始化并支持 worktree 的 Git 仓库
• 包含 context-network/backlog/ 目录结构的 上下文网络
• 位于 context-network/backlog/by-status/*.md 的任务状态文件

工作流类型概览

WORKFLOW TYPES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

TASK CYCLE (Primary)     DAILY                SPRINT
──────────────────────   ──────────────────   ──────────────────
sync                     Morning:             Start:
  ↓                        sync --last 1d       sync --all
next → [CHECKPOINT]        status --brief       groom --all
  ↓                        groom --ready        plan sprint-goals
implement                                       status
  ↓                      Evening:
[CHECKPOINT]               checklist          End:
  ↓                        discovery            sync --sprint
review-code                sync --last 1d       retrospective
review-tests                                    audit --sprint
  ↓                                             maintenance --deep
[CHECKPOINT]
  ↓
apply-recommendations (if issues)
  ↓
merge-prep → [CHECKPOINT]
  ↓
merge-complete
  ↓
update-backlog & status
  ↓
END
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

状态检测

此技能会自动确定当前工作流状态。无需手动跟踪。

检测信号

信号	检查方法	表示
Worktree 存在	git worktree list	任务进行中
任务分支处于活动状态	git branch --show-current 与 task/* 匹配	正在实现
存在未提交的更改	git status --porcelain	正在编写代码
分支已合并	git branch --merged main	可以清理

状态矩阵

STATE DETECTION LOGIC
─────────────────────────────────────────────────────────────
Check                           → State           → Next Step
─────────────────────────────────────────────────────────────
No worktree, no in-progress     → IDLE            → sync, next
Worktree exists, uncommitted    → IMPLEMENTING    → continue implement
Worktree exists, all committed  → READY_REVIEW    → review-code
Reviews complete, ready to merge→ MERGE_READY     → merge-prep
Branch merged, worktree exists  → CLEANUP         → merge-complete
─────────────────────────────────────────────────────────────

详细的检测算法请参阅 references/state-detection.md。

调用模式

# Auto-detect state and continue from where you are
/agile-workflow

# Start specific workflow phase
/agile-workflow --phase task-cycle
/agile-workflow --phase daily-morning
/agile-workflow --phase daily-evening
/agile-workflow --phase sprint-start
/agile-workflow --phase sprint-end

# Resume work on specific task
/agile-workflow --task TASK-123

# Preview what would happen without executing
/agile-workflow --dry-run

任务周期阶段

从选择到合并，完成单个任务的主要工作流。

第 1 步：同步实际状态

确保上下文网络与项目的实际状态一致。

Run: sync --last 1d --dry-run
Purpose: Detect drift between documented and actual state
Output: Sync report showing completions, partial work, divergences

第 2 步：选择任务

确定接下来要处理的任务。

Run: next
Purpose: Find highest priority ready task
Output: Task ID, title, branch name suggestion

检查点：TASK_SELECTED

• 暂停并确认任务选择
• 用户可以接受或选择其他任务
• 接受后：继续实现

第 3 步：实现

在隔离的 worktree 中进行测试驱动开发。

Run: implement [TASK-ID]
Purpose: Create worktree, write tests first, implement, verify
Output: Working implementation with passing tests

检查点：IMPL_COMPLETE

• 实现完成后暂停
• 显示测试结果和覆盖率
• 成功后：继续审查

第 4 步：审查

验证实现质量。

Run: review-code --uncommitted
Run: review-tests --uncommitted
Purpose: Identify quality issues, security concerns, test gaps
Output: Review reports with issues and recommendations

检查点：REVIEWS_DONE

• 显示汇总后的审查结果
• 如果存在严重问题：必须先解决才能继续
• 如果没有问题：自动继续准备 PR
• 由用户决定：立即应用建议，还是稍后处理

第 5 步：应用建议（有条件）

以适当方式处理审查发现。

Run: apply-recommendations [review-output]
Purpose: Apply quick fixes now, defer complex changes to tasks
Output: Applied fixes + created follow-up tasks

第 6 步：准备合并

验证并准备合并到 main。

Run: merge-prep
Purpose: Validate implementation, run final checks, prepare for merge
Output: Ready to merge to main

检查点：MERGE_READY

• 显示验证结果
• 显示将要合并的文件
• 所有检查均通过后：继续合并
• 如果失败：停止并解决问题

第 7 步：完成合并

合并到 main 并进行清理。

Run: merge-complete
Purpose: Merge to main, delete branch, remove worktree, update status
Output: Task marked complete, cleanup done

第 8 步：更新待办列表和项目状态

将进度保存到权威文档中。

Run: Part of merge-complete (Phase 6)
Purpose: Update epic file (task → complete), unblock dependents, update project status
Output: Backlog and project status reflect actual progress

**此步骤为何重要：**如果跳过此步骤，已完成的任务在待办列表文件中仍会标记为“ready”，项目状态也会过时。内部跟踪文件仅在当前会话中有效；待办列表和状态文件才是持久的事实来源。

详细的任务周期说明请参阅 references/phases/task-cycle.md。

每日阶段

用于工作日开始和结束的快捷流程。

晨会（约 5 分钟）

Run sequence:
1. sync --last 1d --dry-run   # What actually happened yesterday
2. status --brief --sprint    # Current sprint health
3. groom --ready-only         # What's ready to work on

Output: Clear picture of today's priorities

晚间总结（约 10 分钟）

Run sequence:
1. checklist                  # Ensure nothing lost
2. discovery                  # Capture learnings
3. sync --last 1d            # Update task statuses

Output: Knowledge preserved, state synchronized

每日详细说明请参阅 references/phases/daily.md。

Sprint 阶段

Sprint 起止时的仪式流程。

Sprint 开始（约 60 分钟）

Run sequence:
1. sync --all                 # Full reality alignment
2. groom --all               # Comprehensive grooming
3. plan sprint-goals         # Architecture and goals
4. status --detailed         # Baseline metrics

Output: Sprint plan with groomed, ready backlog

Sprint 结束（约 90 分钟）

Run sequence:
1. sync --sprint             # Final sprint sync
2. retrospective             # Capture learnings
3. audit --scope sprint      # Quality review
4. status --metrics          # Sprint metrics
5. maintenance --deep        # Context network cleanup

Output: Sprint closed, learnings captured, ready for next

Sprint 详细说明请参阅 references/phases/sprint.md。

检查点处理

检查点是供人工决策的暂停环节。

检查点行为

在每个检查点：

1. 总结刚刚完成的内容
2. 展示关键结果和任何问题
3. 列出后续步骤
4. 等待用户输入

检查点响应

响应	操作
"continue" / "proceed" / "yes"	进入下一步
"stop" / "pause"	保存状态，退出工作流
"back"	重新运行上一步
"skip"	跳过当前步骤（谨慎使用）
自定义输入	可调整下一步的参数

自动继续条件

满足条件时，某些检查点可以自动继续：

检查点	自动继续条件
IMPL_COMPLETE	所有测试均通过，构建成功
REVIEWS_DONE	没有严重或高严重性问题
MERGE_READY	所有验证检查均通过

检查点处理的详细说明请参阅 references/checkpoint-handling.md。

命令参考

每个工作流步骤都使用内嵌的命令说明：

命令	参考	用途
sync	references/commands/sync.md	同步实际情况
groom	references/commands/groom.md	优化任务
next	references/commands/next.md	选择任务
implement	references/commands/implement.md	TDD 实现
review-code	references/commands/review-code.md	代码质量审查
review-tests	references/commands/review-tests.md	测试质量审查
apply-recommendations	references/commands/apply-recommendations.md	分类并应用修复
merge-prep	references/commands/merge-prep.md	准备合并
merge-complete	references/commands/merge-complete.md	合并并清理
discovery	references/commands/discovery.md	记录学习成果
retrospective	references/commands/retrospective.md	工作后分析
maintenance	references/commands/maintenance.md	清理上下文网络

示例：完整任务周期

**场景：**一天开始时，实施下一个可用任务

调用：

/agile-workflow --phase task-cycle

流程：

Agent: Detecting current state...
       No worktree found, checking ready tasks...

Agent: Running sync --last 1d --dry-run
       [Sync output: 0 tasks completed but undocumented]

Agent: Running next
       Found: TASK-042 - Add user preferences endpoint
       Priority: High | Size: Small | Branch: task/TASK-042-preferences

       ╔═══════════════════════════════════════════╗
       ║  CHECKPOINT: Task Selection               ║
       ╠═══════════════════════════════════════════╣
       ║  Selected: TASK-042                       ║
       ║  Proceed with implementation?             ║
       ║                                           ║
       ║  [continue] [stop] [other task]           ║
       ╚═══════════════════════════════════════════╝

User: continue

Agent: Creating worktree at .worktrees/TASK-042/
       Running implement TASK-042
       [Implementation proceeds with TDD...]

       Tests: 12 passing
       Coverage: 87%
       Build: Success

       ╔═══════════════════════════════════════════╗
       ║  CHECKPOINT: Implementation Complete      ║
       ╠═══════════════════════════════════════════╣
       ║  All tests passing, ready for review      ║
       ║  Proceed to code review?                  ║
       ║                                           ║
       ║  [continue] [stop]                        ║
       ╚═══════════════════════════════════════════╝

[Flow continues through review, merge...]

限制

• 需要具有特定待办结构的上下文网络
• 仅适用于 Git 工作流（不集成 PR——PR 工作流请使用 gitea-workflow 或 github-agile）
• 专注于单个任务（不负责编排并行任务）
• 最适合个人开发，或团队信任度高、直接提交到 main 的工作流

相关技能

• gitea-workflow - 适用于集成 PR 的 Gitea 仓库
• github-agile - 适用于集成 PR 的 GitHub 仓库
• skill-maker - 按照 agentskills.io 规范创建新技能
• research-workflow - 适用于实施前的研究任务