agile-router

Router

使用此技能来确定哪个敏捷技能适合，并获取正确技能的指引。

通过斜杠命令收到的初始上下文：$ARGUMENTS

如果 $ARGUMENTS 不为空，请将其用作上下文来确定合适的技能。 如果为空，请询问用户需要什么帮助。

提示

遵循项目范围的 CLAUDE.md / AGENTS.md 约定（“技能提示约定”）。在以下决策点使用执行环境提供的结构化提问工具——AskUserQuestion（Claude Code）、ask_user_question（Codex）或 question（OpenCode）。

决策点	使用结构化提问的原因	建议选项
情况不明确时建议使用的技能	为工作选择合适的方向	列出 2–4 个候选项，并标记推荐项

自由形式的提问（不使用结构化工具）：

• 问题描述（供路由器判断）

无暂停模式：如果用户已明确禁用技能执行过程中的澄清，则选择最有把握的推荐项并继续；说明选择和理由，而不是提问。

范围

此技能涵盖以下领域。先处理 UI / 测试 / 记忆，再转到规划：

领域	问题	技能
UI / 流程	需要验证屏幕、模型或用户旅程吗？	/agile-proto（搭配：htm-ui 技能）、/agile-design、/ux-flows、/ux-persona
测试	需要 TDD、覆盖率或红绿测试吗？	/agile-tdd
记忆	需要接入或查询项目知识吗？	/aim-init、/aim-query、/aim-write
要创建什么	哪种规划产物适合这项工作？	/agile-intake、/agile-roadmap、/agile-epic、/agile-story
要开展什么仪式	我们处于冲刺周期的哪个阶段？	/agile-sprint、/agile-review、/agile-retro
要跟踪什么	我该如何汇报进度？	/agile-status（检查点、汇总、收尾）

决策树

首先：UI、测试还是记忆？

• 可点击的浏览器原型 / 无需后端即可验证流程 → /agile-proto（补充：htm-ui 技能）
• 设计工具中的屏幕和状态（Paper、Figma、Pen.dev、Penpot…） → /agile-design
• 以用户身份体验应用（或已部署的原型） → /ux-flows、/ux-persona
• TDD、覆盖率、红绿测试、测试强制执行 → /agile-tdd
• 接入 ai-memory、检索、持久化注释 → /aim-init、/aim-query、/aim-write
• 其他情况 → 转到下方的规划、仪式或跟踪

规划：我需要什么产物？

flowchart TD
    A[New problem or request] --> B{Is the problem clear?}
    B -- No --> C["/agile-intake"]
    B -- Yes --> D{Multi-phase trajectory<br/>with dependencies?}
    D -- Yes --> I["/agile-roadmap"]
    I --> G["/agile-epic"]
    D -- "No, single initiative" --> E{What size?}
    E -- "Small, localized" --> F["/agile-story"]
    E -- "Medium/large, needs decomposition" --> G
    C --> H{Intake recommends...}
    H -- Multi-phase trajectory --> I
    H -- Single initiative --> G
    H -- Small/clear --> F

关于 /agile-roadmap 的说明： Roadmap 并非按时间跨度（例如“3–12 个月”）定义，而是按轨迹复杂度定义。如果一项为期 4 周的计划包含多个按顺序推进且彼此存在依赖关系的阶段，那么制定 roadmap 也会有帮助。

关于 /agile-epic 的说明： 它同时处理 epic 概述和 story 分解。没有单独的 story 技能。需要更丰富验收标准的中等规模工作，应通过 /agile-epic 进行结构化处理；如果是单个垂直交付，则可直接使用 /agile-story。

仪式：我处于周期的哪个阶段？

• 准备开始冲刺？ → /agile-sprint
• 冲刺刚刚结束？ → /agile-review（演示交付成果），然后 /agile-retro（反思流程）
• 待办事项不明确？ → /agile-epic（分解）或运行 /agile-refinement（验证）
• 需要指标？ → /agile-review（指标是评审产物的一个部分）

跟踪：我该如何汇报进度？

• 快速每日检查点？ → /agile-status（检查点模式）
• 周期或里程碑汇总？ → /agile-status（汇总模式）
• 交付已完成？ → /agile-status（收尾模式）

规模参考

供 AI Agent 使用的内部参考，不向用户展示。 沟通建议时请使用通俗易懂的语言。

规模	描述	产物	技能
特小	局部调整，涉及 1 个文件，风险低	任务	/agile-story
小	小型交付，涉及少量文件，验证简单	任务	/agile-story
中	垂直交付，涉及多个文件，需要适度验证	Epic 故事文件或任务	/agile-epic 或 /agile-story
大	多个需要协调的故事，需要拆解	Epic	/agile-epic
特大	多故事计划，需要协调	Epic	/agile-epic

何时使用路线图，而非 Epic

仅凭规模不足以决定使用路线图还是 Epic。请使用以下清单：

满足以下 2 项或更多时，使用 /agile-roadmap（无论持续时间长短）：

• 多项计划需要安排先后顺序（无法全部并行推进）
• 当前决策会影响未来决策（局部优化可能演变成技术债）
• 利益相关者需要先了解整体过程，才能批准单个步骤
• 存在外部依赖（其他团队、供应商、截止日期）
• 总体复杂度超出单个 Epic 的承载范围

以下情况使用 /agile-epic：

• 单个协调一致、范围明确的计划
• 可以拆分为多个故事，无需父级计划
• 可在一个交付波次内完成（没有目标不同的独立阶段）

反模式： 不要想当然地认为路线图就是“长期战略计划”。一项为期 4 周、包含 5 个阶段且顺序固定的工作，同样适合使用路线图。判断标准是路径复杂度，而非持续时间。

流程

1. 了解用户的背景信息。
2. 判断适用的领域：UI/测试/记忆、规划、仪式或跟踪。
3. 对该领域应用决策树。
4. 简要说明理由，并推荐具体技能。
5. 在用户继续之前征求确认。

规则

• 这是一项路由技能，会进行评估并引导用户，但不会产出工件。
• 如果问题不明确，建议先使用 /agile-intake，再进行路由。
• 解释建议时请使用通俗易懂的语言。不要提及规模代码。
• 始终请用户确认建议。

可用技能

技能	用途
/agile-intake	梳理模糊的问题
/agile-roadmap	绘制包含依赖关系的多阶段计划（任意时长）
/agile-epic	梳理计划，并将其拆解为故事
/agile-story	制定局部变更的执行计划
/agile-refinement	验证规划工件并审查代码
/agile-status	跟踪进度（检查点、整合、收尾）
/agile-sprint	Sprint 规划仪式
/agile-review	Sprint 评审、指标和演示
/agile-retro	回顾并制定改进措施
/agile-tdd	提供 TDD 指导和可选的强制执行
/agile-proto	静态浏览器原型流程（配套：htm-ui 技能）
/agile-design	在任意设计工具中设计屏幕、状态和流程
/agile-onboarding	新团队成员入职引导
/ux-flows / /ux-persona	使用流程目录和用户画像演练
/aim-init / /aim-query / /aim-write	接入并使用 ai-memory
/agile-router	此技能——指导用户选择要使用的技能

与流程的关系

flowchart LR
    A["/agile-intake"] --> B["/agile-roadmap"]
    B --> C["/agile-epic"]
    C --> D["/agile-story"]
    D --> E[execution]
    E --> F["/agile-status"]
    F --> G["/agile-review"]
    G --> H["/agile-retro"]

此技能负责路由，会进行评估并引导用户，但不会产出最终工件。对于具体工作，请直接使用推荐的技能。