agile-onboarding

入职引导

使用此技能，以务实、循序渐进的方式引导新团队成员了解敏捷 + AI 工作流。

提示词

遵循项目范围内 CLAUDE.md / AGENTS.md 中的约定（“Skill 提示词约定”）。对于以下决策点，使用框架的结构化提问工具——AskUserQuestion（Claude Code）、ask_user_question（Codex）或 question（OpenCode）。

决策点	结构化提问的原因	建议选项
角色	决定内容深度和技能集	工程师 · PM · 设计师 · 混合
技能流深度	影响范围	快速（接收问题 → 故事）· 完整（所有技能）· 仅 Wiki

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

• 新成员姓名
• 工龄 / 背景备注

无暂停模式：如果用户明确禁用了技能执行过程中的澄清提问，则将每个结构化提示转换为“待解决问题”（或同等部分）中的条目，然后继续执行，不要阻塞流程。

目标

• 介绍运营模式（轻量 Scrum + AI 结对）
• 通过实践而非理论讲解工件流
• 确保新成员能在 1-2 个冲刺内独立开展工作
• 避免入职引导沦为纯文档——必须包含实践

适用场景

• 新开发人员或经理加入团队
• 有人更换角色（例如开发人员成为技术主管）
• 团队首次采用此工作流
• 有人离开一段时间后需要重新培训

入职引导路径

第 1 天：了解模式

目标： 了解现有内容及其原因。

1. 展示完整工作流：

   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-retro"]
   

2. 讲解角色分工：

   • 人类：决策、验证、管理 git、沟通
   • AI：梳理结构、实现、验证、汇报

3. 展示决策树：

   • 何时使用任务，何时使用史诗
   • 范围评估（从小到大）

4. 展示可用技能以及如何调用每项技能：

   • /agile-intake — 收集问题
   • /agile-roadmap — 制定战略方向
   • /agile-epic — 拆解并梳理各项计划
   • /agile-story — 制定执行计划
   • /agile-refinement — 验证工件并审查代码
   • /agile-status — 跟踪进度（检查点、汇总、收尾）
   • /agile-sprint — 规划冲刺
   • /agile-review — 冲刺评审、指标和演示
   • /agile-retro — 回顾
   • /agile-proto — 静态浏览器原型（通过 htm-ui 技能实现 UI）
   • /agile-design — 使用任意设计工具制作界面、状态和流程
   • /agile-router — 指引应使用哪项技能

第 2 天：实践练习 — 收集问题并规划

目标： 在 AI 的协助下收集问题并制定简单计划。

建议练习：

1. 新成员选择一个真实的小问题（缺陷、改进或任务）
2. 使用 /agile-intake 技能梳理问题
3. 使用决策树判断应创建哪种工件
4. 使用 /agile-router 验证选择，然后通过 /agile-story 或 /agile-epic 制定计划
5. 导师 / 技术主管审查并提供反馈

第 3 天：实践练习 — 使用 TDD 执行

目标： 按照任务 -> TDD -> 验证的流程实现功能。

建议练习：

1. 采用第 2 天创建的计划
2. 与 AI 结对，使用 TDD 实现：
   • 描述预期行为
   • AI 编写测试（红）
   • AI 实现功能（绿）
   • 如有必要，开发人员要求重构
3. 运行验证（lint、类型检查、测试）
4. 提交前运行 /agile-refinement（代码审查模式）审查差异

第 4 天：实践练习 — 跟踪进度

目标： 生成状态更新并通过报告完成收尾。

1. 使用 /agile-status（检查点模式）生成进度更新
2. 模拟一份涵盖该周期的 /agile-status（汇总模式）报告
3. 使用 /agile-status（收尾模式）完成交付
4. 回顾完整链路：任务 -> 执行 -> 状态 -> 收尾

第 5 天：反思与自主工作

**目标：**评估新成员是否已准备好独立开展工作。

1. 新成员独立进行需求收集
2. 无需导师帮助，创建计划或史诗
3. 使用 TDD 实现
4. 通过状态报告收尾
5. 导师进行验证并给出最终反馈

入职清单

• 了解完整流程（从需求收集到回顾）
• 知道如何选择合适的产物（决策树）
• 能在 AI 支持下创建任务或史诗
• 知道如何与 AI 配对使用 TDD
• 知道如何生成状态更新和结项报告
• 了解责任划分（人类与 AI）
• 知道有哪些可用技能，以及何时使用各项技能
• 在监督下完成至少一个完整周期（从需求收集到结项）

按角色调整

面向开发人员

• 重点：TDD、与 AI 配对编程、质量门禁、git 工作流
• 额外练习：使用此流程从头实现一个小功能

面向经理 / Scrum Master

• 重点：路线图、史诗分解、冲刺规划、回顾、状态报告
• 额外练习：在 AI 支持下进行史诗分解和冲刺规划

面向技术负责人

• 兼顾两方面：规划与执行
• 额外练习：使用 /agile-refinement 审查 AI 生成的代码，并给出建设性反馈

规则

• 入职培训不是被动的。新成员必须亲自练习，而不只是阅读。
• 导师不会代替新成员完成任务，而是提供指导并进行审查。
• 入职过程中的错误是改进的机会，而非失败。必须营造安全的试验环境。
• 如果新成员无法在 5 个工作日内完成清单，问题可能出在流程，而非个人。请在回顾中讨论。

与流程的关系

此技能是使用其他所有技能的入口。完成入职培训后，成员应能够自主调用 /agile-router、/agile-story、/agile-status、/agile-sprint 和 /agile-retro。