knowledge-extractor

用途

knowledge-extractor 用于将已被验证的本地适配向上推广：把项目积累的适配转化为一份起草好的晋升提案，并路由给真正控制目标对象的治理负责人。它是手动、按需触发的——当开发者认为某个本地调整看起来具有普遍价值时运行它。它只起草和路由，绝不编辑框架、绝不开启 PR、绝不批准任何内容。

层级：跨领域工具（面向治理，不属于生命周期层）。

何时使用

适用场景：

项目的 .aidoc/profile.yaml / .aidoc/learnings.md 显示出可能应归入框架的重复性适配。
审查本地偏差是否应被标准化。

不适用场景：

创建或维护 profile——那是 ../project-profile/SKILL.md 的职责。
自行编写变更记录或运行门禁——本技能只起草输入；../doc-chg/SKILL.md 和 ../gate-check/SKILL.md 负责 CHG 流程。

行为

框架不附带运行时代码——本技能充当分析者。它读取、分类并起草；由人工将每份草稿带入正确的路径。

1. 读取信号

加载 .aidoc/profile.yaml 和 .aidoc/learnings.md（条目结构见 ${CLAUDE_PLUGIN_ROOT}/framework/governance/ADAPTATION.md §7）。将 profile 与框架默认值做差异对比，列出项目当前的活跃偏差。

2. 判断可推广性（人工）

对每个偏差判断其属于可推广还是项目特有。需综合权衡，不可仅凭单一因素决定：

复现频率（越高 → 越能说明它不是一次性问题）；
conflict: true（项目覆盖了开发者自己的种子 → 信号更弱；按项目设置的例外不太可能具有普遍性）；
理由是项目特定的，还是针对该产物本身的一般性论述。

项目特有的条目保留在本地——明确说明并就此停止。

3. 分类目标归属

对每个可推广条目，判断它实际会改变什么：

若变更涉及模板、治理规则或注册表（framework/）→ 归属为框架规范，路径为 CHG（变更管理）。
若变更涉及引擎如何引导创作（某个技能的检查清单/措辞）→ 归属为平台，路径为普通平台评审（PR）。

4. 路由与起草

规范目标 → 一份 CHG 记录。按 ${CLAUDE_PLUGIN_ROOT}/framework/governance/chg/CHG-TEMPLATE.yaml 的结构编写，设置 change_source: spec、entry_gate: GATE-SPEC 以及 semver_impact（增量 → minor，破坏性 → major）；在 change_description.why / .trigger 中携带来源信息（触发它的 learnings 条目 + profile 键）。将其交给 ../doc-chg/SKILL.md 完成记录，并交给 ../gate-check/SKILL.md 运行 GATE-SPEC（框架规范变更门禁，${CLAUDE_PLUGIN_ROOT}/framework/governance/chg/gates/GATE-SPEC_FRAMEWORK.md）。由人工批准；提取器绝不开启 PR 或授予批准。

引擎引导目标 → 一份可直接提交 PR 的变更描述。指明文件、给出前后对比，并携带相同的来源信息。这是普通的平台变更，不是 CHG 记录（依据 ${CLAUDE_PLUGIN_ROOT}/framework/governance/ADAPTATION.md §7）。

5. 交付

按路径分组呈现草稿，并将项目特有条目列为“保留本地”。绝不应用、开启或批准——由人工决定。

输出契约

框架规范 → CHG 记录（change_source: spec → GATE-SPEC），携带来源信息，状态为“可供 GATE-SPEC 评审”。
引擎引导 → 可直接提交 PR 的变更描述，携带来源信息（文件、前后对比），状态为“可供普通评审”。
两者皆非 → “保留本地”说明，携带理由，无操作。

快速参考

读取 profile + learnings；与默认值做差异对比
判断可推广 vs 项目特有（复现频率 ↑，conflict ↓）
分类归属：规范 → CHG/GATE-SPEC，引导 → PR
起草 + 来源信息（规范记录路由至 GATE-SPEC）
交付；绝不应用/批准

限制

本技能为手动、按需触发，不附带运行时代码，仅负责读取、分类与起草。它不修改框架、不开启 PR、不批准任何变更，最终决定权在人工。关于收费、价格、平台支持范围等信息，资料中暂未提供。

技能介绍

用途