agile-workflow

用途

Agile Workflow 是一个敏捷开发工作流编排技能，用于引导智能体按顺序执行命令，完成结构化的敏捷开发流程。它采用基于检查点的流程控制，在步骤之间自动推进，并在关键决策点暂停，等待人工确认。

该技能适用于以下场景：

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

以下情况不应使用该技能：

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

主要能力

该技能提供多种工作流类型：

• 任务周期（主要）：从任务选择到合并的完整流程，包括同步、选择任务、实现、审查、应用建议、准备合并、完成合并、更新待办与项目状态。
• 每日流程：晨会（约 5 分钟）和晚间收尾（约 10 分钟）。
• 冲刺流程：冲刺开始（约 60 分钟）和冲刺结束（约 90 分钟）。

该技能能自动检测当前工作流状态，无需手动跟踪。检测信号包括：worktree 是否存在、任务分支是否活跃、是否有未提交更改、分支是否已合并等。状态矩阵将检测结果映射为 IDLE、IMPLEMENTING、READY_REVIEW、MERGE_READY、CLEANUP 等状态，并给出下一步操作。

使用方式

调用模式包括：

• 自动检测状态并从当前位置继续：/agile-workflow
• 启动特定工作流阶段：/agile-workflow --phase task-cycle、--phase daily-morning、--phase daily-evening、--phase sprint-start、--phase sprint-end
• 恢复特定任务：/agile-workflow --task TASK-123
• 预览而不执行：/agile-workflow --dry-run

任务周期阶段包含以下步骤：

1. 同步现实：运行 sync --last 1d --dry-run，检测文档与实际状态之间的偏差。
2. 选择任务：运行 next，找到最高优先级的就绪任务。此处有检查点 TASK_SELECTED，暂停确认任务选择。
3. 实现：运行 implement [TASK-ID]，在隔离的 worktree 中进行测试驱动开发。此处有检查点 IMPL_COMPLETE，暂停并显示测试结果与覆盖率。
4. 审查：运行 review-code --uncommitted 和 review-tests --uncommitted，识别质量问题、安全隐患和测试缺口。此处有检查点 REVIEWS_DONE，显示合并审查结果；若有严重问题必须处理，若无问题则自动继续。
5. 应用建议（条件性）：运行 apply-recommendations [review-output]，立即应用快速修复，将复杂变更推迟为后续任务。
6. 准备合并：运行 merge-prep，验证实现、运行最终检查。此处有检查点 MERGE_READY，显示验证结果和将要合并的文件。
7. 完成合并：运行 merge-complete，合并到主分支、删除分支、移除 worktree、更新状态。
8. 更新待办与项目状态：作为 merge-complete 的一部分，更新 epic 文件、解除依赖阻塞、更新项目状态。

每日流程：

• 晨会：依次运行 sync --last 1d --dry-run、status --brief --sprint、groom --ready-only。
• 晚间收尾：依次运行 checklist、discovery、sync --last 1d。

冲刺流程：

• 冲刺开始：依次运行 sync --all、groom --all、plan sprint-goals、status --detailed。
• 冲刺结束：依次运行 sync --sprint、retrospective、audit --scope sprint、status --metrics、maintenance --deep。

检查点处理：在每个检查点，技能会总结刚完成的内容、显示关键结果和问题、呈现下一步，并等待用户输入。用户可回复“continue”“proceed”“yes”继续，“stop”“pause”保存状态并退出，“back”重跑上一步，“skip”跳过当前步骤，或自定义输入调整下一步参数。部分检查点可在条件满足时自动继续，例如 IMPL_COMPLETE 在所有测试通过且构建成功时、REVIEWS_DONE 在无严重或高严重性问题时、MERGE_READY 在所有验证检查通过时。

适用场景

该技能适合单人开发或可信团队直接合并到主分支的工作方式。它要求 Git 仓库支持 worktree，并需要上下文网络具备特定结构：待办事项位于 context-network/backlog/，任务状态文件位于 context-network/backlog/by-status/*.md。

限制

• 需要具备特定待办结构的上下文网络。
• 仅基于 Git 的工作流，不包含 PR 集成；如需 PR 工作流，应使用 gitea-workflow（Gitea 仓库）或 github-agile（GitHub 仓库）。
• 单任务聚焦，不编排并行任务工作。
• 最适合单人开发或可信团队直接合并到主分支的工作流。

相关技能

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