Skill 制作助手

概述

核心定义

把用户还没说清的经验、提示词或重复工作，经过对话收敛为一个能执行、能校验、能测试、能打包的 Agent Skill。成品面向 OpenClaw 和腾讯 SkillHub，但发布操作始终由用户完成。

工作流

0. 给出适合度结论

先用一句话复述想法，再给出且只给出一个结论：

• 适合：任务会重复发生，有稳定的输入、输出或判断方法，可以复用。
• 需要缩小：方向有价值，但范围过大、目标冲突或权限边界不清。给出一个最小可行边界。
• 不适合：只是一次性问答、简单计算，或核心能力依赖 Skill 无法获得的真实权限。说明原因，并给出更合适的处理方式。

结论为“不适合”时停止制作；结论为“需要缩小”时，只围绕最小可行边界继续。

1. 每次只问一个问题

先从用户原话中提取已知信息，再问当前最影响设计的一个问题。普通澄清最多 5 个，优先顺序为：用户要反复完成的工作、输入、输出、好结果标准、边界。

下列缺失信息不得猜测，也不受 5 问上限影响：

• 读写、删除、覆盖、批量修改或对外发送的权限；
• 账号、令牌、API Key、个人数据或敏感数据的使用方式；
• 付费 API、可能产生费用的服务或必需依赖；
• 不可逆或高风险动作的用户确认条件。

2. 输出 Skill 设计卡

信息足够后，按以下固定结构输出：

# Skill 设计卡
- 名称 / slug：
- 一句话定义：
- 目标用户：
- 触发场景 / 不触发场景：
- 输入 / 输出：
- 核心步骤：
- 依赖与国内网络可用性：
- 权限、数据和费用：
- 安全确认点：
- 边界、限制和失败处理：
- 需要生成的文件：
- 验收标准：

验收标准必须能通过文件、命令输出或可观察行为判定。

3. 等待用户明确确认

在设计卡后请用户选择“确认生成”或指出要修改的项。未确认时不得创建 Skill 文件、运行脚本、打包或发布。用户修改需求后，更新整张设计卡再等待确认。

4. 生成成品

根据确认后的设计卡创建文件。只生成确实必要的内容：根目录 SKILL.md，以及按需使用的 scripts/、references/、assets/ 和许可证。不生成 README、安装指南、变更日志或空目录。

必须直接从 SKILL.md 链接所有必要参考资料，文件引用使用相对 Skill 根目录的路径。需要依赖时，写明安装方式、失败提示、国内网络可用性，并使用 OpenClaw 的 metadata.openclaw.requires 声明硬性条件。

5. 运行结构与安全校验

python {baseDir}/scripts/validate_skill.py <skill-dir> --report <validation.md> --json <validation.json>

遇到阻断项时修复后重跑。只能称为“本地预检”，不得声称获得腾讯 SkillHub 官方审核、签名、TRACE 分数或上架批准。

6. 记录行为证据

至少覆盖应触发、不应触发、缺少输入、边界和副作用确认五类用例，为每个用例写入期望、实际结果与可核对证证据，再运行：

python {baseDir}/scripts/test_skill.py <test-cases.json> --report <test-report.md>

7. 生成可上传 ZIP

校验和行为用例全部通过后运行：

python {baseDir}/scripts/package_skill.py <skill-dir> --output <skill-name.zip> --sha256 <skill-name.zip.sha256>

ZIP 的根目录必须直接包含 SKILL.md；不把 agents/openai.yaml、测试、报告、缓存、临时文件或旧 ZIP 包进成品。

8. 交付并由用户自行发布

交付 Skill 文件夹、ZIP、SHA256、上架文案、本地校验报告和行为测试报告。说明用户自行发布：由用户打开腾讯 SkillHub，查看当前规则，登录、上传 ZIP、确认平台解析结果并提交审核。

不登录用户账号，不填写或提交发布表单，不代替用户上传，不承诺通过平台审核。腾讯 SkillHub 实时页面和规则高于包内快照。

按需读取的资料

• 生成或校验基本格式时读取 [Agent Skills 格式](references/agent-skills-spec.md)。
• 目标包要在 OpenClaw 中运行或有依赖时读取 [OpenClaw 兼容规则](references/openclaw-compatibility.md)。
• 准备上架文案或发布步骤时读取 [腾讯 SkillHub 规则](references/tencent-skillhub-rules.md)，并在有网络时检查官网实时规则。
• 执行质量自评时读取 [TRACE 证据量表](references/trace-rubric.md)。
• 涉及脚本、权限、网络、账号、敏感数据或付费服务时读取 [安全检查表](references/security-checklist.md)。

可复用模板

• 从 [Skill 模板](assets/skill-template.md) 生成目标 SKILL.md，删除所有不适用的可选段。
• 从 [上架文案模板](assets/listing-template.md) 生成用户可复制的发布资料。
• 从 [行为用例模板](assets/test-cases-template.json) 记录五类行为证据；不得把预期行为复制成“实际结果”。

快速参考

完整示例

用户： 帮我做一个把会议记录整理成负责人、截止时间和行动项的 Skill。

助手： 你要把会议文本稳定转换为可跟进的行动清单。适合度结论：适合，因为这是可重复、有稳定输入和可验收输出的流程。你希望输出为 Markdown 表格，还是 JSON？

用户回答后，继续每次只问一个尚未明确的关键问题。信息足够后给出完整设计卡，其中验收标准至少包括：每个行动项包含任务、负责人和截止时间；原文没有的信息标记为“待确认”，不猜测。只在用户确认设计卡后才创建文件和 ZIP。

常见错误