القائمة
可观测性与模型降质检测。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）