name: skill-capture-closure description: 任务结束后的统一复盘入口，同时覆盖「修改」（识别并修复 B/K 对象缺陷）和「沉淀」（将新经验/洞见写入对应 B/K 对象）两个方向。主分类轴：B-object（Skill/Rule/Agent）vs K-object（原则/框架/规范/项目规格/碎片），操作类型：modify（修改已有）或 create（新建沉淀）。触发词：「复盘一下」「做个复盘」「这次踩坑了」「这个经验值得记」「跑通了」「总结经验」「沉淀一下」「记录一下这次」。注意：项目级批量复盘请触发 project-retrospective。

任务复盘（skill-capture-closure）

核心原则：复盘 = 修改（B/K 对象有缺陷 → 修复）+ 沉淀（新经验/洞见 → 写入系统）

主分类轴是「目标对象类型（B/K）」，不是「经验现象类型」。

• B-objects = 行为规范（Skill / Rule / Agent）
• K-objects = 知识对象（原则 K0 / 框架 K1 / 参考 K2 / 规范 K3 / 项目规格 K4 / 碎片）

知识导航表（执行前必须理解的概念根）

本 Skill 的步骤设计基于以下文档的核心概念。若不理解这些概念，步骤无法正确执行。 执行前应确认已理解（或快速扫读关键章节）。

核心概念速查（如无法读完整文档，至少理解这三条）：

① B-object（行为对象）= 编码「在条件C下执行动作A」的可执行规则
   = Skill（任务流程）/ Rule（普遍约束）/ Agent（隔离执行器）
   → 修改 B-object = 改变系统的行为方式

② K-object（知识对象）= 编码「关于世界的陈述性事实」的知识文档
   = K0原则 / K1框架 / K2外部参考 / K3执行规范 / K4项目规格 / fragment
   → 修改 K-object = 更新系统的知识储备

③ D_op = modify（修复：对象已存在但有缺陷）
        vs create（沉淀：对象应存在但尚未存在）
   → 复盘 = 找出所有 modify Gap + create Gap，分别处理

激活后立即执行（顺序不可跳过）

Step 1  【建立知识基础】
        Read: .cursor/skills/skill-index/SKILL-INDEX.md
        → 了解现有 Skill 全貌，防止重复新建

Step 2  【双向诊断】产出 Gap 清单

        ─── 修复方向（向后看，找失败）───
        ① 这次任务哪里执行不符合预期？
        ② 哪个 B-object（Skill/Rule/Agent）步骤不清晰/不完整/有问题？
        ③ 哪个 K-object（文档/规范/踩坑速查）内容有误、过时或缺失？

        ─── 沉淀方向（向前看，找收获）───
        ④ 有什么新发现/洞见值得记录？
        ⑤ 有什么可复用模式，但目前没有对应的 B-object？
        ⑥ 有什么实践经验，下次遇到同类任务会用到？

        → 对每个有内容的问题，产出一条 Gap 记录（一句话描述）
        → 若全部为空 → 输出「本次无需复盘，任务已完整执行」，结束

Step 3  【Gap 分类】对每条 Gap，按三个维度分类

        维度1 — 目标对象类型：
          B-object = 行为规范（Skill / Rule / Agent）
          K-object = 知识对象（原则/框架/参考/规范/项目规格/碎片）

        维度2 — 操作类型：
          modify = 对象已存在，内容需修改（来自修复方向 ①②③）
          create = 对象应存在但不存在，需新建（来自沉淀方向 ④⑤⑥）

        维度3 — 子类型：
          B → Skill | Rule | Agent
          K → K0原则 | K1框架 | K2外部参考 | K3规范 | K4项目规格 | fragment

        → 输出分类清单，确认后进入 Step 4

Step 4  【根因诊断】仅对 B-object.modify 类型执行，K-object 和 create 类型跳过

        ────────────────────────────────────────
        问题A：AI 是否知道相关规范的存在？

        → 【不知道】→ 根因：【连接缺口】
          规范/文档没有通过 D0 / alwaysApply Rule / Step 1 进入 AI 上下文。
          → 产物方向：修复连接机制（补 D0 行 / 新建 Rule / 调整引用位置）

        ────────────────────────────────────────
        → 【知道，但没执行】→ 继续问题B：

        问题B：规范通过什么机制传递的？

        → 只在某个被触发的 Skill 里（Skill 这次没被触发）：
          根因：【类型错误】应升为 alwaysApply Rule
        → 规范在 Rule/D0 中，但表述模糊/有歧义：
          根因：【规范质量问题】重写使其更明确
        → 规范表述是「建议/应该」而非「必须/禁止」：
          根因：【执行力度不足】升级为禁止表述
        → 以上皆否，AI 确实疏忽了：
          根因：【执行层疏忽】加注意事项/提醒即可

        ────────────────────────────────────────
        → 输出：「根因：[类型] — [一句话说明]」
        → 写入后续 ceremony 变更记录的「经验核心」字段

Step 5  【路由执行】按 Step 3 分类，对每条 Gap 执行对应 ceremony

        B-object ceremonies：
          B.Skill.modify   → Step B-S-M
          B.Skill.create   → Step B-S-C
          B.Rule.modify    → Step B-R-M
          B.Rule.create    → Step B-R-C
          B.Agent.modify   → Step B-A-M
          B.Agent.create   → Step B-A-C

        K-object ceremonies：
          K.K3.modify      → Step K-3-M
          K.K3.create      → Step K-3-C
          K.K1.modify      → Step K-1-M
          K.K1.create      → Step K-1-C
          K.K0.modify      → Step K-0-M
          K.fragment       → Step K-F-C
          K.K2.*           → Step K-2
          K.K4.*           → Step K-4

Step 6  【注册更新】所有 ceremony 执行完后
        → B-object 有变动 → 更新 SKILL-INDEX（版本/状态/日期 + 底部变更记录）
        → 新建 Skill 时 → 执行 role-menu 同步检查（见下方说明）
        → K-object 有变动 → 不更新 SKILL-INDEX

Step 7  【收尾反馈】
        「✅ 复盘完成：
          修改类：B-object [N] 个 / K-object [M] 个
          沉淀类：B-object [N] 个 / K-object [M] 个
          [每条处理结果简述]」

B-object Ceremony 步骤

Step B-S-M  【更新已有 Skill】
        执行 skill-rule-修改规范「修改前三问」：
          1. 根因：触发本次更新的真实事件是什么？
          2. 影响：哪些已有执行路径会改变？
          3. 验证：如何验证修改有效且无副作用？
        三问完毕后：
          a. 备份：cp → .cursor/skills/[目录名]/history/SKILL_v旧版_YYYYMMDD.md
          b. 最小化修改（只改本次经验相关的部分）
          c. 追加变更记录到 SKILL.md 底部（格式见下方「变更记录格式」）

Step B-S-C  【新建 Skill】
        推断并向用户确认：
        「准备新建 Skill：
          目录名：[kebab-case，最多6段，含语义]
          类别：[角色类 | 流程类 | 能力类 | 系统治理类 | 写作类]
          触发词：[3-5个关键词]
          核心能力（一句话）：[...]
          [确认新建] [调整后新建]」
        确认后：
          a. mkdir .cursor/skills/[目录名]/
          b. Write SKILL.md（含 frontmatter + 步骤 + 注意事项 + 变更记录）
          c. 如有辅助文件需要，一并创建

Step B-R-M  【更新已有 Rule】
        Read: .cursor/rules/[对应rule文件]
        执行 skill-rule-修改规范 完整流程：
          → 修改前三问 → 备份到 history/ → 最小化修改 → 追加变更记录

Step B-R-C  【新建 Rule】
        基于经验设计：
          - name + description（含触发条件）
          - alwaysApply: true/false 判断
          - 核心约束内容（< 300词，只写约束，不写流程）
        Write: .cursor/rules/[rule-name].mdc
        追加变更记录到 Rule 文件底部
        检查：新 Rule 是否需要配套 Skill？

Step B-A-M  【更新已有 Agent】
        Read: .cursor/agents/[对应agent文件]
        执行 skill-rule-修改规范 完整流程（Agent 适用相同规范）：
          → 修改前三问 → 备份到 .cursor/agents/history/ → 最小化修改 → 追加变更记录

Step B-A-C  【新建 Agent】
        → 告知用户：「需要新建独立子智能体，建议触发 skill-designer Level 2 流程」
        → 或由本次上下文直接引导 skill-designer 设计

K-object Ceremony 步骤

Step K-3-M  【更新已有规范文档 K3】
        目标范围：
          - _内部总控/开发规范/*.md（通用开发规范、踩坑速查）
          - .cursor/skills/[role]/knowledge/[踩坑速查].md（角色专属）
          - 任何跨项目可复用的执行规范
        执行：
          1. Read 目标文件头部，确认当前版本号
          2. cp → [所在目录]/history/[文件名]_v[版本]_YYYYMMDD.md
          3. StrReplace 最小化修改（只改本次经验相关部分）
          4. 更新版本号，追加变更记录：
             ### v[新版本] — YYYY-MM-DD — [触发事件一句话]
             **根因**：[本次踩坑/发现描述]
             **修改内容**：[改了什么]

Step K-3-C  【新建规范文档 K3】
        场景：有明确实践经验，但对应规范文档不存在
        判断放哪里：
          通用开发经验 → _内部总控/开发规范/[新文件名].md
          角色专属经验 → .cursor/skills/[role]/knowledge/[新文件名].md
        Write 新文档：
          - 文件头含版本号（v1.0）+ 创建日期 + 用途说明
          - 正文：经验内容
          - 末尾：变更记录章节

Step K-1-M  【更新认知框架文档 K1】
        目标：_内部总控/认知结构/L1_系统性文档/ 下的文档
        ⚠️ K1 是核心认知文档，不直接 Write，必须走受控更新：
        → 触发 cognitive-update-knowledge Skill（含备份+矛盾检测+变更记录）
        → 本步骤仅路由，不自行执行 Write

Step K-1-C  【新建认知洞见 → 碎片暂存】
        场景：深度框架性发现，但尚不足以直接写 K1 系统性文档
        执行：
          1. Write 到 _内部总控/认知结构/L2_碎片化思考/[领域]/YYYYMMDD_[主题].md
             格式：
             ## [主题标题]
             **日期**：YYYY-MM-DD
             **来源**：[触发此洞见的任务]
             **内容**：[洞见展开描述]
             **待整合到**：[推测的 L1 文档方向，可留空]
          2. 在碎片整合索引追加一行：
             | F-XXX | [标题] | 🔲 待整合 | [日期] | [领域] |

Step K-0-M  【更新原则库 K0】
        ⚠️ K0 稳定性最高，修改前必须用户明确确认
        → 输出：「发现可能需要更新原则库：[描述]。这是底层原则（K0），
          修改影响全系统。请选择：
          [确认修改 → cognitive-extract-principle]
          [降级为 K1 碎片 → K-1-C]
          [暂不处理]」
        → 用户确认后触发 cognitive-extract-principle（已有完整流程）

Step K-F-C  【碎片轻量捕获 fragment】
        场景：模糊的想法/洞见，尚不清晰，先轻量记录
        执行：
          1. 在 _内部总控/认知结构/L2_碎片化思考/ 对应领域目录下：
             Write YYYYMMDD_[主题关键词].md（简短描述即可）
          2. 在碎片整合索引追加一行：
             | F-XXX | [标题] | 🔲 待整合 | [日期] | [领域] |
        注：轻量，不需要备份，不需要版本号

Step K-2   【外部参考文档 K2】
        目标：_内部总控/认知结构/L1_系统性文档/*/知识库/*.md（REF-EXT）
        场景：发现某份调研报告内容需要补充/更新
        执行：
          1. 追加补充内容到对应调研报告
          2. 在文档末尾追加变更记录一行

Step K-4   【项目规格文档 K4】
        目标：项目群/[项目]/产品经理/*.md 或 技术架构师/*.md
        执行：同 K-3-M ceremony（Read版本 → 备份 → 修改 → 版本+变更记录）
        注：通常 session-bootstrap B3.5 已触发，此处作为主动补充路径

Step 6 说明：SKILL-INDEX 更新与 role-menu 同步

更新 SKILL-INDEX：

【版本号规则（内联，无需翻其他文件）】
  - 核心逻辑/步骤顺序/新增 Step 变动 → 第二位 +1（v1.0→v1.1）
  - 注意事项/触发词/description/文字修正 → 第三位 +0.1（v1.0→v1.0.1）
  - 全新创建 → v1.0

【新建 Skill】→ 在对应类别表格追加一行：
  | [目录名] | v1.0 | 🔵 待验证 | [今日日期] | [触发词] | [核心能力] |

【更新已有 Skill】→ 更新对应行：
  - 版本号递增
  - 成功闭环经验 → 状态改为 ✅ 已验证
  - 踩坑修复 → 修复前标 ⚠️，修复后改回 ✅
  - 最近更新日期 → 今日

同时在索引底部「变更记录」追加一行：
  [日期] | [Skill目录名] | v旧→v新 / 新建v1.0 | [一句话摘要]

role-menu 同步检查（新建 Skill 时必须，更新时跳过）：
  应加入 role-menu 的条件（满足任一）：
  □ 用户会直接说某句话触发它
  □ 它是角色类 Skill（role-*）
  □ 有新触发词，与现有 role-menu 不重叠

  不需要加入的：
  □ 能力层 Skill（被其他 Skill 调用，不被用户直接触发）
  □ 认知系统内部 Skill

  若应加入 → 告知用户，按 skill-rule-修改规范 备份 role-menu.mdc 后追加
  若不需要 → 静默跳过

变更记录格式

每次新建或更新 Skill/Rule 时，在文件底部追加：

---

## 变更记录

### v[版本号] — YYYY-MM-DD — [变更标题（一句话）]

**根因**：[触发本次修改/创建的真实事件]

**经验核心**：[这次学到了什么 / 踩了什么坑 / 根因类型（连接缺口/类型错误/规范质量/执行力度/执行层疏忽）]

**修改内容**：
- 新增：[章节/条目] → [说明]
- 修改：[章节/条目] → [从什么改成了什么]
- 删除：[章节/条目] → [为什么删除]

**验证结果**：
- 正向验证：[场景] → [结果]
- 负向验证：[场景] → [结果]

**验证状态**：🔵 待验证 / ✅ 已在真实场景跑通

注意事项

• 双向都要问：每次复盘必须同时问「什么坏了（修复）」和「学到了什么（沉淀）」，不能只问一个方向
• 对象类型优先：主分类是 B-object 还是 K-object，不是「这是 Skill 问题还是文档问题」
• 最小化原则：每次只改与本次经验相关的部分，不顺手重构
• K1 不直接写：K1 认知框架文档必须走 cognitive-update-knowledge，不在本 Skill 里直接 Write
• K0 必须确认：原则库修改影响全系统，必须用户确认后才执行
• 索引必须同步：B-object 有变动时，SKILL-INDEX 必须同步更新

变更记录

v2.1 — 2026-03-23 — 新增知识导航表（D0 认知根确认）

根因：Skill 只有机械步骤，没有背景概念导航。AI 执行时不理解「B-object」「K-object」「D_op」「ceremony」等核心概念的来源，导致步骤形同虚设。这是一个普遍性的 Skill 设计缺陷（「只有细节，没有背景」）。

经验核心：根因 = 连接缺口（核心概念来自形式规范，但 Skill 没有指向这些文档）

修改内容：

• 新增：「知识导航表」章节，包含 D0/D3/D4 四个层级的导航条目
• 新增：「核心概念速查」——三条最关键概念的内联定义，确保 AI 无需读完整文档也能理解分类逻辑

验证结果：

• 正向验证：AI 激活 Skill 时，应能理解「B-object vs K-object」分类的含义，而非机械套用
• 负向验证：知识导航表是「指引读哪里」，不是把文档内容复制进来，Skill 本体不变厚

验证状态：🔵 待验证

备份路径：history/SKILL_v1.4_20260323_before_v2.md（v2.0 已覆盖此备份，v2.1 不另建）

v2.0 — 2026-03-23 — 重构主分类轴：从现象分类→对象类型分类，同时覆盖修复与沉淀

根因：讨论记录 _内部总控/skill-system-design/复盘体系重设计讨论记录_20260323.md 系统性分析发现三个缺陷：

1. 主分类轴是「现象类型（R/A/D/S）」而非「对象类型（B/K）」，导致 K-object 路径不系统
2. 只有修复方向（找失败），缺少沉淀方向（找收获），D_op = create 无明确路径
3. 与认知体系（cognitive-capture-fragment）是两个独立入口，未统一

经验核心：根因类型 = 类型错误（分类轴用了现象而非对象类型）+ 连接缺口（K-object 沉淀无路径）

修改内容：

• 修改：description → 扩展为「修改+沉淀」双向，明确 B/K 主分类轴
• 修改：Step 2（原「理解本次经验」）→ 双向诊断（修复方向+沉淀方向 6 个问题）
• 修改：Step 2.5（原「四型前置分类 R/A/D/S」）→ Step 3「B/K 二分 + D_op + 子类型」
• 移动：Step 2.1（根因诊断）→ Step 4，仅对 B-object.modify 触发
• 重命名：Step R1/R2/A1/A2/D/3-8 → Step B-R-M/C/B-A-M/C/B-S-M/C
• 新增：K-object ceremony 全路径（K-3-M/C、K-1-M/C、K-0-M、K-F-C、K-2、K-4）
• 修改：Step 6（索引更新）→ 明确仅 B-object 更新 SKILL-INDEX，K-object 不更新
• 更新：注意事项 → 增加双向诊断原则、K1 不直接写、K0 必须确认

验证结果：

• 正向验证A（修复）：执行后发现 Skill 步骤有误 → Step 3 分类为 B.Skill.modify → Step 4 根因诊断 → Step B-S-M 更新
• 正向验证B（沉淀K3）：发现踩坑值得写入规范 → Step 3 分类为 K.K3.create → Step K-3-C 新建
• 正向验证C（沉淀K1碎片）：有认知洞见 → Step 3 分类为 K.K1.create → Step K-1-C 写入碎片
• 负向验证：任务无任何 Gap → Step 2 全部为空 → 输出「无需复盘」，不继续执行
• 负向验证B：纯 B-object 修改任务 → K-object ceremony 不被触发

验证状态：🔵 待验证（下次任务复盘时跑一遍完整路径）

备份路径：history/SKILL_v1.4_20260323_before_v2.md

v1.4 — 2026-03-23 — 新增 Step 2.1 结构性根因诊断

根因：AI 反思时只诊断表层，忽略规范机制设计缺陷。 修改内容：新增 Step 2.1「结构性根因诊断」（5类根因：连接缺口/类型错误/规范质量/执行力度/执行层疏忽） 备份路径：history/SKILL_v1.3_20260323_before_meta-diagnosis.md

v1.3 — 2026-03-23 — 新增 Step 2.5 四型前置分类

根因：Step 3 只有三种输出，Rule 类和 Agent 类经验被强行塞入 Skill 流程。 修改内容：新增 Step 2.5「四型前置分类（R/A/D/S）」，新增 Step R1/R2/A1/A2/D。 备份路径：history/SKILL_v1.2_20260323_before_multi-type.md

v1.2 — 2026-03-21 — 新增 Step 7.5 role-menu 同步检查

根因：新建 Skill 后 role-menu 未同步，触发词前置拦截失效。 备份路径：history/SKILL_v1.1_20260321.md

v1.1 — 2026-03-19 — 修复三项沙盘推演漏洞

修改内容：触发词歧义修复、变更记录格式统一、版本号规则内联。

v1.0 — 2026-03-19 — 初始创建