| 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 的步骤设计基于以下文档的核心概念。若不理解这些概念，步骤无法正确执行。
执行前应确认已理解（或快速扫读关键章节）。
| 层级 | 文档 | 需要理解的关键概念 |
|---|
| D0 认知根（必读） | _内部总控/认知结构/L1_系统性文档/系统架构思维维度/自进化智能体系统形式规范_v1.0.md | 层1：B/K/S 三类对象定义；层2：间隙（Gap）定义；层5：R/M/G 基础设施；层7：D_op = {create, modify, delete, merge, split} |
| D3 规范参考 | _内部总控/认知结构/L1_系统性文档/系统架构思维维度/Skill体系设计原则_v1.0.md | §2.2 Rule 本质；§2.3 Skill 本质；§2.4 Agent 本质；§2.5 三型统一决策树 |
| D3 对象分类 | _内部总控/认知结构/L1_系统性文档/系统架构思维维度/系统对象全量分类表_20260320.md | 类型A（Rule）/ B（Skill）/ C（Agent）/ E（认知文档）/ G（开发规范）的完整定义与存放位置 |
| D4 运行时数据 | .cursor/skills/skill-index/SKILL-INDEX.md | 当前所有 B-objects 的目录名、版本、状态（Step 1 读取） |
核心概念速查（如无法读完整文档，至少理解这三条）：
① 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
系统性分析发现三个缺陷：
- 主分类轴是「现象类型（R/A/D/S）」而非「对象类型（B/K）」，导致 K-object 路径不系统
- 只有修复方向（找失败），缺少沉淀方向（找收获），D_op = create 无明确路径
- 与认知体系（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 — 初始创建
