Skill Forge 技能熔炉

技能熔炉 — 锻造/评估/改进 Skill。说 技能熔炉 走全流程（含R5改进已有skill）；说 技能评估/skill评估/评估技能 只做同类比对+腾讯9维度。可选能力：搜索SkillHub同类技能（通过TRAE内置工具）、修改已有skill文件（仅R5诊断修复路径，需用户确认）。发布环节请用 skill-publisher。Do NOT use for skill security vetting, skill publishing (use skill-publisher), or general coding tasks.

技能熔炉 v6.4.0

锻造 → 评估，两入口全流程交付可自动触发、稳定输出的 Skill。发布环节由独立的 skill-publisher 技能承接。

入口检测

触发词	入口	执行流程
技能熔炉	Phase -1	前置闸门→入口路由→访谈→确认门→同类预检→创建→验证→评估→发布交接提醒
技能评估 / skill评估 / 评估技能	Phase 2	只做 SkillHub 同类比对 + 腾讯9维度

检测到触发词后，立即跳转到对应 Phase，不执行前面的阶段。

发布不在本技能范围内：当用户说"技能发布/发布技能/更新技能/迭代技能"时，应触发 skill-publisher，不是本技能。

撰写原则（5 大原则，必读）

完整 5 大原则详见 references/authoring-principles.md — 创建 Skill 前必读，作为"声明-行为一致性"的硬门控。原三条铁律映射到原则 1/1/4，补充原则 3（最小权限）和原则 5（用户知情）：

原则	一句话	对应原铁律
1. 声明-行为一致性	name/description/metadata/行为四者对齐	铁律1 Description先行（扩展）
2. 权力比例适当	副作用强度 ≤ 用户预期 + 披露程度	（新增）
3. 最小权限	allowed-tools 只列实际需要的工具	（新增）
4. 渐进式披露	SKILL.md ≤200 行，细节下沉 references/	铁律3 渐进式披露
5. 用户知情	有副作用必须 README 警告 + 关闭方式	（新增）

原"铁律2 一Skill一职"已并入原则 1（声明-行为一致性）：description 必须明确单一职责，多功能 Skill 触发混乱本质是声明-行为不一致。

权限声明

本技能实际使用的能力类别（用户须知）：

能力类别	是否使用	说明
网络访问	✅	通过 TRAE 内置工具搜索 SkillHub 同类技能（不直接发起网络请求）
文件读写	✅	在用户指定目录创建/修改 skill 文件（SKILL.md/references/scripts/assets）
环境变量	❌	不读取任何环境变量（无凭证需求）
subprocess	❌	不调用任何外部命令
外部 API	❌	不调用任何外部 API（SkillHub 同类搜索由 TRAE 内置工具完成）

用户警告：本技能会在用户指定目录创建/修改 skill 文件（R1-R4 创建新 skill，R5 可修改已有 skill）。R5 修改已有 skill 前需用户确认诊断结果。如不希望写入文件，可在确认门前终止流程。本技能不执行任何发布操作（发布由 skill-publisher 承接）。

SKILL.md 格式（完整 frontmatter 示例）

markdown

---
name: "<skill-name>"
slug: "<skill-name>-ai"
displayName: "<Skill Name>"
description: "<做什么 + 何时触发 + Do NOT 范围. 核心关键词放前200字符>"
version: "<MAJOR.MINOR.PATCH>"
license: "MIT-0"
summary: "<一句话摘要>"
allowed-tools: "<工具白名单>"
metadata:
  openclaw:
    skillKey: "<skill-name>"
    emoji: "<emoji>"
    homepage: "<https://github.com/...>"
    os: ["windows", "macos", "linux"]
    requires:
      bins: []
      env: []
    primaryEnv: ""
    envVars: []
    always: false
---

# <技能标题>
## 任务
## 输出格式
## 规则
## 示例
## 故障排除（可选）

目录结构

text

<skill-name>/
├── SKILL.md          # 主入口（≤200行）
├── references/       # 长文档、方法论、详细案例
├── scripts/          # 可执行脚本（确定性操作）
├── assets/           # 模板、schema、示例文件
├── README.md         # 中英双语说明
├── CHANGELOG.md      # 版本日志
├── LICENSE           # MIT-0
└── .claude-plugin/plugin.json

---

Phase -1: 前置闸门

【入口：技能熔炉】 — 读取 references/pre-gate-and-routing.md 获取完整闸门+路由方法论。

动手前先判断三件事，该劝退就劝退：

检查	通过	劝退
值不值得做？最近一周≥3次？做法固定？输出可预期？	≥2个Yes → 继续	一次性任务→"直接问AI更快"
有没有现成的？SkillHub上有同类吗？	没有 or 有差距 → 继续	有且很好→"建议安装: skillhub install "
是不是太大了？该拆成几个？	单一场景 → 继续	多场景→"建议拆开，先做哪个？"

Phase 0: 入口路由与需求共创

【入口：技能熔炉】 — 读取 references/pre-gate-and-routing.md Part 2-3 + references/interview-flow.md 获取完整方法论。

Step 0.1: 五类入口路由

入口	信号	策略
R1 从零想法	"我想做个skill"	自适应访谈（Step 0.2）
R2 从对话提取	"把刚才对话变成skill"	扫描上下文→提取步骤→生成草稿→确认门→Step 0.4
R3 从现成材料	给文档/SOP	分析材料→反推四要素→补缺→确认门→Step 0.4
R4 从草稿完善	给半成品SKILL.md	反推四要素→确认门→Step 0.4 同类预检→补全→验证
R5 改进已有skill	"不触发/跑偏/太啰嗦"	诊断：症状→检查点→动作→修复→验证

Step 0.2: 自适应访谈（2-5轮，一次一问）

水平自适应：从用户措辞判断水平。张口pandas→用术语；说"差不多就行"→换大白话。全程不问"你几级"。

一次一问：每轮只问1个问题+2-3个选项。一次甩3个问题，用户只会挑最好答的。

四要素：做什么 / 何时触发 / 输入输出 / 边界。≥3个明确→进入确认门。

Step 0.3: 确认门

理解没对齐，绝不动手写。

text

我理解是这样——
· 做什么：[一句话]
· 何时触发：[用户会说的话]
· 输入：[格式]；输出：[格式]
· 边界：[不做什么]
这样对吗？没问题我就开始写了。

用户确认 → Step 0.4 同类预检。用户纠正 → 修正后重新确认。

Step 0.4: 同类预检（创建前）

【入口：技能熔炉】 — 读取 references/composition-and-pipeline.md 获取组合与管线编排方法论。

适用范围：所有创建类入口（R1/R2/R3/R4）的确认门通过后必须执行。R5 改进类跳过（走诊断模式）。即使用户带着成熟的想法、现成仓库、教程材料或半成品草稿调用，也不能跳过此环节——必须先收敛递归转写为四要素 plan，确认门对齐后再做同类预检。

确认门通过后，立即搜索 SkillHub，避免重复造轮子：

分支	条件	动作
a) 有现成的更好	找到高质量同类(≥7分)	建议安装已有Skill，结束流程
b) 有但不够好	有同类但有明显差距	提取差异点→作为Phase 1设计输入
c) 无同类	没有同类Skill	直接进入Phase 1创建
d) 可组合	需求可分解为多个原子操作	元技能组合+管线编排建议

分支d详解：需求分解为原子操作→逐个搜索→评估覆盖率：

• 全组合：所有步骤都有高质量Skill→建议安装+编排管线，无需新建
• 部分组合：部分有高质量→安装已有的+只新建缺失的
• 全新建：无高质量同类→直接Phase 1

---

Phase 1: 创建

【入口：技能熔炉】

Step 1: Description先行 + 触发优化迭代

格式: "<做什么>. 当用户说<触发词>时触发. Do NOT use for <排除范围>."

触发优化迭代：初版description写完后，用5条真实用户说法测试触发准确率。触发不准→自动迭代用词。最多3轮。

Step 2: 撰写4+1模块

任务（锁定边界）/ 输出格式（固定结构）/ 规则（3-5条，实习生测试）/ 示例（完整输入输出）/ 故障排除（可选）

Step 3: 创建目录和文件

有确定性操作→创建 scripts/。有模板样式→创建 assets/。

Step 4: 分层验证

默认轻量验证（小白/日常）：

• Step 4a: Schema检查 — 完整 10 项自检清单见 references/authoring-principles.md §六（含 frontmatter 字段齐全 / description 三要素 / SKILL.md ≤200 行 / allowed-tools 最小权限 / metadata.openclaw 声明 / 无凭证硬编码 / Lethal Trifecta / CHANGELOG 版本一致 / plugin.json 一致）
• Step 4b: 安全红线（7条RED FLAG）
• Step 4c: 跑给你看 — 拿真实输入跑一遍→看结果→确认/微调

可选重型验证（老手/严谨场景）：

• Step 4d: 触发测试 — 5条真实用户说法+3条反向
• Step 4e: 量化评分（0-10）
• Step 4f: 基线对比（有Skill vs 无Skill）

最多3次迭代。3次后建议"先发布V1再迭代"。

---

Phase 2: 质量自评 + 差异化验证

【入口：技能评估 / skill评估 / 评估技能】 — 读取 references/benchmarking-guide.md。

角色调整：同类搜索已前移到 Step 0.4（创建前）。Phase 2 现在聚焦于创建后的质量自评和差异化验证。

Step 5a: 腾讯9维度自评 — 触发精准度/关键词前置/Do NOT/单一职责/4模块/输出具体性/实习生测试/示例覆盖/体积控制。逐维度自评，标出弱项。

Step 5b: 差异化验证 — 如果 Step 0.4 发现有同类，验证差异化优势是否落地。如果无同类，跳过。

Step 5c: 盲区修复 — 列出弱项和盲区，附腾讯手册依据，提出修复方案。

Step 5d: 用户决策 — 采纳修复 / 保持原样。用户决策为最终决策。

---

发布交接提醒

触发条件：Phase 2 评估完成（Step 5d 用户选择"保持原样"或"采纳修复且修复完成"），且用户未选择"直接安装已有"。

触发时提示：

Skill 已通过锻造与评估。如需发布到 GitHub + ClawHub + SkillHub，请说"技能发布"或"发布技能"调用 skill-publisher 技能，它负责：前置条件校验 → 仓库结构生成 → 安全审查 → 版本号查重 → 三平台推送 → 发布后验证 → 本地安装同步。

不要在本技能内执行任何发布操作。 发布是独立技能 skill-publisher 的职责，本技能仅负责锻造与评估。

---

References

• authoring-principles.md — 5 大撰写原则 + frontmatter 规范 + 6 大反模式 + 10 项自检清单（v5.2 新增，从 skill-auditor 反哺）
• pre-gate-and-routing.md — Phase -1 闸门 + 五类入口路由 + 改进诊断脚本
• interview-flow.md — 一次一问 + 水平自适应 + 确认门 + B1-B6规则
• composition-and-pipeline.md — Step 0.4 元技能组合 + 管线编排方法论
• interview-methods.md — 行为追问、偏误检测、选项法深度参考
• benchmarking-guide.md — 腾讯9维度自评模板 + 差异化验证
• meeting-action-extractor-example.md — 完整Skill示例