ln-161-skill-creator

**路径：**文件路径（references/、../ln-*）相对于此技能目录。

ln-161-skill-creator

**类型：**L3 Worker（可独立运行） **类别：**1XX 文档流水线

从流程文档章节创建 .claude/commands/*.md 斜杠命令文件。它会将流程性正文转换为命令式指令，同时不更改源文档。

---

概述

方面	详情
输入	已批准的流程章节，或独立文档扫描
输出	目标项目中的 .claude/commands/*.md 文件
模板	references/templates/command_template.md
读取模式	以章节为先的 Markdown 读取

---

输入模式

模式	触发条件	行为
提供的章节	上下文包含 approved_sections	直接使用提供的章节
独立模式	使用 $ARGUMENTS 直接调用	自行发现、分类并创建命令

独立发现

在未提供 approved_sections 的情况下调用时：

1. 阅读 references/procedural_extraction_rules.md、references/procedural_skill_sop_guide.md、references/markdown_read_protocol.md 和 references/docs_quality_contract.md
2. 优先扫描文档来源：
   • docs/**/*.md
   • tests/README.md
   • tests/manual/**/*
   • README.md
   • CONTRIBUTING.md
3. 仅使用 AGENTS.md、CLAUDE.md 和 docs/project/.context/doc_registry.json 来引导发现
4. 使用共享的流程提取规则对候选章节进行分类
5. 向用户展示提取计划以供批准
6. 创建已批准的命令

---

工作流

阶段 1：准备

接收或构建以下规范化输入：

{
  "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：转换并创建

对于每个已批准的章节：

1. 使用共享的 Markdown 读取协议读取源章节
2. 如果所选范围中出现标准化文档框架内容，则忽略以下内容：
   • DOC_KIND、DOC_ROLE、READ_WHEN、SKIP_WHEN、PRIMARY_SOURCES 等标题标记
   • Quick Navigation
   • Agent Entry
   • Maintenance
3. 检测 allowed-tools

内容模式	工具
shell 命令或围栏代码块 bash / sh	Bash
文件读取或配置检查	Read
文件更新	Edit
搜索步骤	Grep、Glob
技能调用	Skill
审批关卡	AskUserQuestion

4. 按照以下规则转换内容：

规则	来源	转换为
语态	陈述性正文	命令式指令
代码块	源 shell 代码块	可执行时保留
编号列表	文档正文	有序工作流步骤
验证	隐含的预期	明确的验证检查
高风险流程步骤	隐含假设	操作、要点、原因、证据、例外、自动化/防护措施
决策点	融入正文	明确的 IF/ELSE 分支，并要求每个分支提供证据
依赖项/预检	假定的环境	在变更或外部调用前执行的首个自检
例外情况	隐含的故障排除	明确的暂停/重试/询问路径
文档框架	元数据和导航	移除
源文档出处	仅隐含提及	明确的 Source 部分
相关文档	行内引用	Related Documentation 部分

5. 如果 .claude/commands/{command_name} 文件尚不存在，则写入该文件

阶段 3：报告

返回：

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"

---

关键规则

• 模板驱动： 所有输出均遵循 references/templates/command_template.md。
• 保留源文件： 切勿修改或删除源文档。
• 不得臆造： 不要添加源文件中不存在的命令、步骤或路径。
• 使用祈使语气： 每条保留的指令都必须可执行。
• SOP/TWI 提取： 对高风险流程步骤，保留操作、决策点、例外、验证、依赖项/预检，以及风险原因。
• 不复制文档框架： 不要将 DOC_KIND、DOC_ROLE、Quick Navigation、Agent Entry 或 Maintenance 复制到命令中。
• 来源溯源： 每条生成的命令都必须指向其来源文档和章节。
• 相对路径： 文件引用必须相对于项目根目录。
• 幂等： 跳过已有的命令文件；不要覆盖它们。

完成定义

• 已收到或发现获批章节
• 已按照章节优先协议阅读源章节
• 已检测每条命令允许使用的工具
• 已将内容转换为祈使式工作流步骤
• 高风险流程步骤在适用时包含操作、关键点、原因、证据、例外和自动化/防护措施
• 已从命令输出中移除标准文档框架内容
• 每个创建的命令都包含来源溯源信息
• 未覆盖已有的命令文件
• 已返回创建报告

---

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