菜单
可观测性与模型降质检测。Use when 一次开发会话结束、需要记录 Session 摘要、或怀疑模型出现降质（反复返工、标准滑坡、摸鱼）时。也适用于需要追踪 Issue 状态、生成 PR 摘要、复盘 token 花费的场景。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
对照 Issue 与验收标准开发。Use when 一个 Issue 被分配、准备写代码/写测试/修 Bug 时。也适用于需要按验收标准实现功能、并保证产出包含测试与示例、提交前自查的场景。
Use when 需要在当前项目中实现新功能、优化现有代码或修复 bug。触发场景：用户提出功能需求、代码需要重构、发现 bug 需要修复、需要对齐架构文档规范进行开发。
问题记录与定期总结提炼。Use when 同一问题反复出现、Milestone 结束、或需要把踩过的坑提炼成可复用规则/新 Skill 时。也适用于定期复盘、更新验收标准或拆分策略、沉淀方法论的场景。
任务归约拆分与验收标准前置。Use when 已有 Spec 或较清晰的需求、要把大需求切成可执行任务、准备启动开发之前。也适用于需求太大、一个 Agent 无法独立完成、需要拆成 Epic/Milestone/Issue 并定义 P0-P3 验收标准的场景。
需求规格评审。Use when 启动新项目/新功能、需求还模糊、在任务拆分或写代码之前，需要先和用户对齐需求边界并产出结构化 Spec 时。也适用于用户给的需求一句话太笼统、缺少边界与非功能性要求的场景。
Use when 进入一个新项目或项目结构发生重大变化，需要生成/更新架构文档（docs/ARCHITECTURE.md）。触发场景：首次接入项目、重构后文档过时、新成员需要上下文、agent 需要理解项目全貌。
| name | observe-session |
| description | 可观测性与模型降质检测。Use when 一次开发会话结束、需要记录 Session 摘要、或怀疑模型出现降质（反复返工、标准滑坡、摸鱼）时。也适用于需要追踪 Issue 状态、生成 PR 摘要、复盘 token 花费的场景。 |
为长期运行建立可观测性：Issue 状态看板、PR Summary、Session 摘要，并基于指标检测模型降质，及时干预。
核心原则： 看得见才管得住。降质要靠指标早发现，而不是等结果烂了才察觉。
标准流转：todo → in-progress（标注 Agent）→ in-review → blocked（标注原因）→ done。
本地/单人退化为 PLAN.md 表格或编辑器 TODO 列表。
每次会话结束记录（用 templates/session-summary-template.md），存入 docs/session-summaries/：处理的 Issue、用的 Skill、错误与解法、Token 消耗、是否摸鱼。
每个 PR 末尾附摘要（用 templates/pr-summary-template.md）。
| 指标 | 正常值 | 告警阈值 | 处理方式 |
|---|---|---|---|
| Review 轮次 | 1-2 轮 | ≥ 4 轮 | 检查 Issue 是否太大，或换模型 |
| 同一问题反复 | 0 次 | ≥ 2 次 | 检查验收标准是否清晰 |
| 标准滑坡 | 无 | P0 被标为 P2 | 强制重读标准文档 |
| Issue 完成率 | > 80% | < 50% | 拆分 Issue，或换模型 |
识别信号： 连续 3 个 Issue review > 4 轮 → 换模型；review 开始说"差不多了合吧" → 查滑坡；同一 Bug 修 2 次没好 → 模型在摸鱼。
docs/session-summaries/）、PR Summary、降质告警与处理建议templates/session-summary-template.md、templates/pr-summary-template.mdskills/improve-retro/SKILL.md（把记录提炼成规则/新 skill）docs/AI 编程方法论 v1.2 — 可操作版.md 第四章（Observe）