用途
ln-160-docs-skill-extractor 用于从项目文档中提取过程性内容，并将其转换为可执行的 slash command 文件，写入目标项目的 .claude/commands/*.md。声明性文档保留为 markdown，该技能只将过程性章节路由为命令形式。
主要能力
- 文档优先提取：仅从文档来源提取。AGENTS.md 和 CLAUDE.md 只用于路由发现，永不作为命令来源。
- 章节优先阅读：在完整读取文件前，使用共享的 markdown 阅读协议。对大文件或不熟悉的文件先使用大纲，先读取头部标记和顶部章节，只展开可能包含流程的章节。
- 先检测后提取：只提取被分类为过程性的章节。
- 无重复：跳过已被现有 .claude/commands/*.md 覆盖的章节。
- 需要用户批准：未经阶段 3 确认，绝不创建命令。
- 委派创建：所有命令文件写入均通过 ln-161。
- 委派审查：所有命令验证均通过 ln-162。
- 保留文档：源文档保持完整。
使用方式
技能按以下六阶段工作流执行：
阶段 1：发现 — 强制读取 references/procedural_extraction_rules.md、references/markdown_read_protocol.md 和 references/docs_quality_contract.md。构建 docs-first 清单。路由来源（AGENTS.md、CLAUDE.md、docs/project/.context/doc_registry.json 如存在）仅用于路由发现和优先级排序，不从中提取命令。提取来源包括：docs//*.md、tests/README.md、tests/manual//、README.md、CONTRIBUTING.md，并扫描 .claude/commands/.md 以避免重复创建命令。若存在 doc_registry.json，优先顺序为 canonical docs 优先，DOC_KIND=how-to 先于 reference，reference 先于 index 和 explanation。忽略标准文档外壳章节作为提取候选。
阶段 2：分类 — 使用共享的过程提取规则对每个候选章节评分。条件：PROCEDURAL（proc >= 4 且 proc > decl * 2）提取为命令；DECLARATIVE（decl >= 4 且 decl > proc * 2）保留为文档；MIXED（两者均 >= 3）仅提取过程性子章节；THIN（两者均 < 3）跳过。过滤：丢弃已被现有命令覆盖的章节、丢弃标准文档外壳章节、当多个章节语义重叠时优先 DOC_KIND=how-to。
阶段 3：提取计划（用户批准关卡） — 在创建文件前向用户展示分类结果集，包含来源、DOC_KIND、章节、分数和建议命令名。用户可回复编号、all 或 all skip N。若用户未批准任何项，则以 No skills to create 停止。
阶段 4：委派给 ln-161（技能创建） — 仅将通过批准的章节传递给 ln-161-skill-creator。必须通过 Skill 工具调用：Skill(skill: "ln-161-skill-creator")，并传入已批准章节的标准化 payload（含 source_file、section_header、line_range、command_name、doc_kind、doc_role）。收集创建的文件路径、来源到命令的映射以及每条命令摘要。
阶段 5：委派给 ln-162（技能审查） — 在 COMMAND 模式下将创建的命令路径传递给 ln-162-skill-reviewer。必须通过 Skill 工具调用：Skill(skill: "ln-162-skill-reviewer", args: "commands")。收集每个文件的判定以及聚合的 pass/fix/warn 计数。
阶段 6：报告 — 聚合创建和审查结果，输出指标表（扫描文档数、分析章节数、发现过程性数、创建命令数、跳过命令数、审查 PASS/FIXED/WARN 数）以及创建的命令列表。
适用场景
当文档中包含部署、测试或故障排查等操作流程时使用该技能。
限制与说明
- 必须通过 Skill 工具调用 worker，不得内联 worker 逻辑，也不得在未执行目标技能的情况下将 worker 标记为完成。
- Codex 环境若无 Skill 工具，需在可用技能中定位命名技能，读取其 SKILL.md，将 args 视为 $ARGUMENTS，执行该技能工作流后返回结果。
- Meta-Analysis 为可选参考，仅在用户要求运行后元分析或协议格式的运行反思时加载 references/meta_analysis_protocol.md，在阶段 6 完成后运行。
- 版本：1.0.0；最后更新：2026-03-26。
完成定义
路由来源已检查（AGENTS.md、CLAUDE.md、doc registry 如存在）；提取清单从 docs-first 来源构建；每个候选章节均已分类；用户批准了提取计划；ln-161 创建了所有已批准命令；ln-162 审查了所有已创建命令；最终报告聚合了扫描、创建和审查指标。