ln-161-skill-creator

用途

ln-161-skill-creator 属于 1XX Documentation Pipeline 分类，是一个 L3 Worker（可独立运行）。它的核心作用是把程序性文档（procedural documentation）章节转换为 .claude/commands/*.md 斜杠命令文件，将说明性散文转换为命令式指令，且不修改源文档。

主要能力

从已批准的程序性章节或独立文档扫描中生成命令。
输出到目标项目的 .claude/commands/*.md 文件。
使用模板 references/templates/command_template.md。
采用 section-first 的 markdown 读取模式。
检测并写入允许的工具（allowed-tools）。
内容转换规则包括：将陈述性散文转为命令式指令、保留可执行的 shell 代码块、将编号列表转为有序工作流步骤、把隐含期望转为显式验证、为高风险步骤补充动作/要点/原因/证据/例外/自动化或守卫、把决策点转为显式 IF/ELSE 分支、把前置依赖转为首个可执行自检、把隐含排障转为具体的暂停/重试/询问路径、移除文档外壳内容、显式标注来源。

输入模式

已提供章节（Provided sections）：当上下文包含 approved_sections 时，直接使用提供的章节。
独立模式（Standalone）：直接以 $ARGUMENTS 调用时，自行发现、分类并创建命令。

独立发现流程

当未提供 approved_sections 时：

读取 references/procedural_extraction_rules.md、references/procedural_skill_sop_guide.md、references/markdown_read_protocol.md 和 references/docs_quality_contract.md。
扫描 docs-first 来源：docs//*.md、tests/README.md、tests/manual//*、README.md、CONTRIBUTING.md。
AGENTS.md、CLAUDE.md 和 docs/project/.context/doc_registry.json 仅用于路由发现。
使用共享的程序性提取规则对候选章节分类。
向用户展示提取计划以供批准。
创建已批准的命令。

使用方式

工作流阶段

阶段 1：准备（Prepare）——接收或构建规范化输入：

{
  "approved_sections": [
    {
      "source_file": "docs/project/runbook.md",
      "section_header": "Deployment",
      "line_range": [45, 92],
      "command_name": "deploy.md",
      "doc_kind": "how-to",
      "doc_role": "canonical"
    }
  ]
}

强制读取：加载 references/templates/command_template.md 和 references/procedural_skill_sop_guide.md。

阶段 2：转换与创建（Transform and Create）——对每个已批准章节：

使用共享 markdown 读取协议读取源章节。
忽略选中范围内出现的标准化文档外壳内容，例如 DOC_KIND、DOC_ROLE、READ_WHEN、SKIP_WHEN、PRIMARY_SOURCES 等头部标记，以及 Quick Navigation、Agent Entry、Maintenance。
检测 allowed-tools：shell 命令或 fenced bash/sh 块对应 Bash；文件读取或配置检查对应 Read；文件更新对应 Edit；搜索步骤对应 Grep、Glob；技能调用对应 Skill；审批门对应 AskUserQuestion。
按转换规则进行内容转换。
如果 .claude/commands/{command_name} 尚不存在，则写入。

阶段 3：报告（Report）——返回创建结果：

created:
  - file: .claude/commands/deploy.md
    source: docs/project/runbook.md#Deployment
    lines: 85
    tools: [Bash, Read]
summary: "Created 1 command from 1 procedural section"

适用场景

适用于需要把文档中的操作流程、部署步骤、运行手册等程序性内容，转换为可被 AI 代理直接执行的斜杠命令的场景。适合拥有规范化文档（如 runbook、how-to 文档）并希望从这些文档自动派生命令的项目。

关键规则与限制

模板驱动：所有输出遵循 references/templates/command_template.md。
保留源文档：绝不修改或删除源文档。
不发明内容：不添加源中不存在的命令、步骤或路径。
命令式语气：每条保留的指令必须可执行。
SOP/TWI 提取：对高风险程序步骤保留动作、决策点、例外、验证、依赖/预检和原因。
不复制文档外壳：不要将 DOC_KIND、DOC_ROLE、Quick Navigation、Agent Entry 或 Maintenance 复制到命令中。
来源溯源：每个生成的命令都必须指回其源文档和章节。
相对路径：文件引用必须保持相对项目根目录。
幂等：跳过已存在的命令文件，不覆盖它们。

完成定义（Definition of Done）

已收到或发现已批准章节
使用 section-first 协议读取源章节
为每个命令检测 allowed-tools
内容已转换为命令式工作流步骤
高风险程序步骤包含动作、要点、原因、证据、例外及适用的自动化/守卫
已从命令输出中移除标准文档外壳内容
每个创建的命令都包含来源溯源
未覆盖已有命令文件
已返回创建报告

版本：1.0.0，最后更新：2026-03-26。