ai-knowledge

在已共识 SOLUTION 上按六章分段「澄清 → 生成 → 烤干」细化 FR/MVP/依赖/风险， 并直写 ANALYSIS-{IDEA-ID}.md；每段写前意图澄清，写入后自动 grilling 至收敛，用户确认后再推进下一段。 用户提到 /sdx-analysis、拆 MVP、需求分析、细化方案且可对齐上游 SOLUTION 时，使用本技能。 分流：无 SOLUTION、只要其他 SDX 阶段或 docs-* 主路径 → 对应技能，不以本技能代跑。 推进见 references/gates.md。

逐步确认参数，按模板分段「澄清 → 生成 → 烤干」直写 SOLUTION-{IDEA-ID}.md； 每段写前意图澄清，写入后自动 grilling 至收敛，再由用户确认推进。 用户提到 /sdx-solution、写方案、整理业务目标、需求模糊要结构化成共识级解决方案、 写 SOLUTION-*.md / 七章方案、一口气写完整版、选 F 补齐剩余章节时，务必使用本技能（分段协议与 F 门禁；非法整篇覆盖也须加载本技能以拒绝）。 分流：ANALYSIS/PRD/ASD/DSD/TDD 或 docs-* 主路径 → 对应技能，不以本技能代跑。 推进见 references/gates.md。

维护或初始化仓库根目录 README.md 与 AGENTS.md。 用户提到 /docs-agent、入口与 INDEX 不同步、口述「写 README」「更新 AGENTS」时，使用本技能。 分流：用户只要 docs-indexing/docs-build/docs-upgrade 或 SDD/distill/extract → 对应技能。 推进见 references/gates.md。

将 overview 知识按表格行内副标题链接归档到 system/company 视角章节； 先收口方案确认书，再按当前单元落目标章并按策略回写 overview。 用户提到 /docs-archive、知识归档、overview 落盘、冲突检查、确认书归档时，使用本技能。 分流：任意源提炼 → docs-extract；应用蒸馏 → docs-distill；实体/KNOWLEDGE_INDEX → docs-build；术语替换 → docs-upgrade；SDD → 对应技能。 推进见 references/gates.md。

从五视角提取实体 ID，产出 per-entity {ID}.md、各视角 README、扫描生成 KNOWLEDGE_INDEX.md；依赖主 Index Guide。 用户提到 /docs-build、初始化/同步知识实体、对齐 ID、docs-indexing 下游要实体时，使用本技能。 分流：仅 INDEX → docs-indexing；overview → distill/extract；归档 → docs-archive；SDD → 对应技能。 推进见 references/gates.md。

从 Git、CHANGELOG*、本地 mtime 三源采集变更，写入 {output_dir}/CHANGE-LOG.md，文末保留增量基线注释。 用户提到 /docs-change、变更聚合、「记录改动」「最近改了什么」时，使用本技能。 分流：INDEX / 实体 / 归档 / 术语为主路径 → docs-indexing、docs-build、docs-archive、docs-upgrade。 推进见 light-flow-actions（C/M/S/F，无 G）与 references/gates.md。

将 system/application-{name}/ 已核实内容蒸馏写入 system/knowledge/overview/{APPNAME}-overview.md 第三列； overview 成功后再追加 DISTILL-LOG。 用户提到 /docs-distill、知识蒸馏、DISTILL-LOG、同步应用知识到系统 overview、更新系统库 overview、 某应用知识库改了要同步、看看要同步哪些内容、系统库 overview 需要更新， 或要把 application-* 已核实变更上行到系统库时，务必使用本技能。 分流：任意源提炼 → docs-extract；overview 归档 → docs-archive；INDEX → docs-indexing；SDD → 对应技能。 推进见 references/gates.md。

按段落关键词相关度从 `--sources` 提炼业务知识，写入 `--overview` 第三列（A/U/D）； 支持 `--dry-run`，不写 `DISTILL-LOG`。 用户提到 /docs-extract、提炼进 overview、从设计文档整理进知识库、sources 写第三列时，使用本技能。 分流：应用上行蒸馏 → docs-distill；overview 归档 → docs-archive；INDEX → docs-indexing；SDD → 对应技能。 推进见 references/gates.md。

生成九章索引指南（各文档根固定为 INDEX-GUIDE.md），维护各 DOC_DIR 下 changelogs/INDEXING-LOG.md 主表（最新在上）。 用户提到 /docs-indexing、建/更索引、文档地图、Onboarding、整理 INDEX 时，使用本技能。 分流：实体/KNOWLEDGE_INDEX → docs-build；overview → docs-distill/extract；SDD → 对应技能，勿单跑本技能吞下游。 推进见 references/gates.md。

OKF bundle refresh、校验与可视化：刷新 index.md、validate-okf、viz.html 与产物校验。 须先读 .docsconfig：DOC_DIR→默认 bundle，KNOWLEDGE_TYPE→默认 viz；BUNDLE/--bundle 覆盖时 viz 跟随 bundle 目录名；无 config 或缺 KNOWLEDGE_TYPE 硬中止。 用户提到 /docs-okf、OKF refresh、刷新 viz、DOC_DIR、DOC_ROOT、KNOWLEDGE_TYPE、目标工程 OKF 时，使用本技能。 分流：用户只要 docs-build 提取或 docs-indexing 九章为主路径 → 对应技能。 推进见 references/workflow.md。

按 knowledge-links.yaml 从本地 path 同步到联邦槽位（system/application-{APPNAME}/ 或 company/system-{SYSNAME}/），并追加槽位 changelogs/CHANGE-LOG.md。 用户提到 /docs-pull、从应用/系统本地仓回拉到联邦槽位、同步槽位、按 knowledge-links 拉取时，使用本技能。 分流：推送中央规约到应用库 → docs-push；overview 蒸馏 / 归档 / SDD → 对应技能。 推进见 light-flow-actions（C/M/S/F，无 G）与 references/gates.md。

按 knowledge-links.yaml 将中央规约复制到各应用本机 path×doc_dir（legacy spec → specs/；spec-asd → requirements/…/specs/）。 用户提到 /docs-push、推 spec 到应用库、按 knowledge-links 同步规约时，使用本技能。 分流：仅 docs-pull / distill / SDD / overview 时 → 对应技能；DSD 正文一般不经本技能。 推进见 light-flow-actions（C/M/S/F，无 G）与 references/gates.md。

就地优化 Markdown：金字塔结构、激进精简、SSOT 去重改引用。 用户提到 /docs-simplify、精简文档、去啰嗦、金字塔、去重引用、结构化改写、压缩正文时，使用本技能。 分流：术语统一 → docs-upgrade；INDEX/CHANGE-LOG/归档/实体主路径 → 对应技能。 写作原则 SSOT：[agent/references/docs-simplify.md](../../references/docs-simplify.md)。推进见 references/gates.md。

为 system/company overview 下 *-overview.md 做关键词相关度：候选词 → YAML 附录 → 表行 ✅ → 架构摘录（phase 3）。 用户提到 /docs-tag、扫描关键词、给概览打标签、phase 3 时，使用本技能。 分流：第三列提炼 / 全文术语 / INDEX → docs-extract、docs-upgrade、docs-indexing。 推进见 light-flow-actions（C/M/S/F，无 G）与 references/gates.md。

定向改 Markdown、注释、配置文本；统一术语并沿引用链 + 关键词链式同步。 用户提到 /docs-upgrade、改文档、统一术语、把 X 换成 Y，或简写 a - b / a > b / a 2 b（均为 a→b）时，使用本技能。 分流：用户只要 docs-archive/change/indexing/build 或仅 CHANGE-LOG/INDEX → 对应技能；结构精简/SSOT 去重 → docs-simplify。 推进见 references/gates.md。

基于已共识 PRD 按 §1-§3 分段「澄清 → 生成 → 烤干」直写 ASD-{IDEA-ID}-{N}.md； 每段写前意图澄清，写入后自动 grilling 至收敛，再由用户确认推进。 用户提到 /sdx-architect、ASD、边界、变更、§3 规约摘要或 spec-asd-* 且可对齐上游 PRD 时，使用本技能。 分流：API/DDL/DSD → sdx-design；docs-* 或仅其他 SDX 阶段 → 对应技能，不以本技能代跑。 推进见 references/gates.md。

基于已共识 PRD 与 ASD/spec-asd 按 §1-§3 分段「澄清 → 生成 → 烤干」直写 DSD-{IDEA-ID}-{N}.md； 每段写前意图澄清，写入后自动 grilling 至收敛，再由用户确认推进。 用户提到 /sdx-design、编写/修改 DSD、API、DDL、错误码、幂等、时序、validate-dsd 且可对齐上游 ASD 或 spec-asd 时，使用本技能。 分流：只要 PRD/ASD/TDD/docs-* 主路径 → 对应技能，不以本技能代跑。 推进见 references/gates.md。

在已共识 ANALYSIS 当前 MVP 上按十一章分段「澄清 → 生成 → 烤干」直写 PRD-{IDEA-ID}-{N}.md； 每段写前意图澄清，写入后自动 grilling 至收敛，再由用户确认推进。 用户提到 /sdx-prd、写 PRD、细化用户故事/业务流程且可对齐上游 ANALYSIS 时，使用本技能。 分流：无 ANALYSIS、只要其他 SDX 阶段或 docs-* 主路径 → 对应技能，不以本技能代跑。 推进见 references/gates.md。

基于已共识 PRD 与 DSD（及 ASD）按六章分段「澄清 → 生成 → 烤干」直写 TDD-{IDEA-ID}-{N}.md； 每段写前意图澄清，写入后自动 grilling 至收敛，再由用户确认推进。 用户提到 /sdx-test、测试方案、用例、TDD、PRD/DSD 转测试时，使用本技能。 分流：只要上游 SDX 正文或 docs-* 主路径 → 对应技能，不以本技能代跑。不产出自动化代码与执行报告。 推进见 references/gates.md。