skill-creator-plus

Skill Creator+

设计并审查可复用、能可靠触发且保持精简的 skill。

决策流程

先判断用户是否真的需要一个 skill。

需求	使用
可复用的多步骤工作流，带有捆绑的脚本、参考资料或模板	Skill
单一的聚焦斜杠任务，带参数化输入（仅限本地 harness；对 Agent Host 已弃用）	Prompt
始终启用或限定文件范围的指引	Instruction
人设、工具限制、委派或交接	Custom Agent
确定性强制或生命周期自动化	Hook

如果答案不是 Skill，就停下来，改为创建正确的原语。

上表は「skill にすべきか」の即時ゲート。

→ references/customization-primitives.md 查看完整选择指南

何时使用

• Create skill、/create-skill、new skill、review skill、fix skill trigger、SKILL.md、workflow、スキル作成
• 从零创建新 skill
• 从对话、事故或清单中提取重复的工作流
• 更新或重构现有 skill
• 审查现有的 SKILL.md 文件
• 在编写之前判断某项自定义是否应作为 skill

从这里开始

1. 提取你想要打包的工作流。
2. 只澄清缺失的维度：目标成果、个人范围还是工作区范围、清单还是完整工作流。
3. 起草最小可用的 SKILL.md，然后把细节移到参考资料中。

许可与验证关卡

在创建或修改目标之前先对其进行分类：自行编写、 第三方或衍生。自行编写的目标使用独立 内容；复制本 Skill 的文字、代码、模板或声明会让它成为 衍生作品，并需要保留上游证据。

对于新的自行编写 Skill，建议将 CC BY-NC-SA 4.0 作为候选，展示 确切的署名显示方式，并获取确认。不要悄悄地把本 Skill 的 Apache-2.0 许可复制到目标中。在更新或导入时，保留现有的或上游的 许可。

使用目标许可配置文件和 验证通道。基线审查始终 必需；Python 辅助工具和打包则为条件性要求。

注意事项

• init_skill.py --path 接收的是已存在的父目录；目标会变成 <path>/<skill_name>。传入 Skill 目录本身会嵌套出一个重复目录。
• 会生成三个产物：SKILL.md、LICENSE.txt、skill-license.json。
• quick_validate.py 会将 LICENSE.txt 的内容逐字与渲染后的模板进行比对，并要求 metadata.author 与 authorAttribution.value 逐字符相等。切勿手工编辑 LICENSE.txt；用该工具重新生成，再把结果覆盖过去。
• 通过校验只能证明一致性，不能证明正确性。 清单会对模板渲染出的任何内容做哈希，因此损坏的模板会生成一份损坏的声明，却依然能通过校验。搭建完成后，请阅读一次渲染出的 LICENSE.txt。
• 分类取决于来源是否为你独立创作，而非复制这一行为本身。复用你自己的材料仍属于 self-authored；只有 third-party 和 derivative 才需要 PROVENANCE.md 和 upstreamAttributions。
• 没有 skill-license.json 的 Skill 会被视为旧版，跳过内容比对，因此修复共享模板不会使较旧的 Skill 失效。而带有清单的 Skill 在模板变更后会以 profile snapshot disagrees 失败：用工具链重新渲染 LICENSE.txt 和 profile 快照（self-authored），或仅刷新快照（derivative）。
• 将 Skill 导入另一个仓库时，请用该仓库的工具链重新生成 LICENSE.txt 和 skill-license.json。清单会锁定模板哈希，因此复制过去的一对文件在那里会校验失败。
• 上传到 Microsoft 365 Agent Builder（Preview，仅限 Frontier）之前，请对照文档中的限制做桌面检查：每个 Agent 8 个 Skill，zip 50 MB，SKILL.md 少于 20,000 个字符，目录深度 3，350 个文件，脚本仅限 .py .js .mjs .cjs .ts .mts .sh .bash（不支持 .ps1），且沙箱中无网络、无安装。package_skill.py 会把文件嵌套在 <skill_name>/ 下，而文档中的示例把 SKILL.md 放在 zip 根目录；两种布局的导入均未经验证，因此不要对此作出承诺。来源：learn.microsoft.com/microsoft-365/copilot/extensibility/declarative-agent-skills

核心原则

原则	说明
简洁是关键	上下文窗口是共享的。只添加 Claude 尚不知道的内容。
发现优先	描述是路由入口。触发条件必须明确。
自由度	根据任务的脆弱程度匹配具体程度（高/中/低自由度）
渐进式披露	分为 3 个层级：元数据 → 正文 → 参考
先整合再添加	在追加更多内容之前，先更新、合并或替换现有指引。
选对原语	好的 skill 不是提示词/Agent/指令设计的兜底方案。
先定范围再建文件	在创建任何内容之前，先确定工作区还是配置文件。
自包含	skill 必须自带其知识。打包到 references/scripts 中；不要只是链接到工作区文件（指令、记忆、账本），这些文件一旦复制到别处就会失效。将环境相关的值（路径、名称）抽象为参数/配置。

默认假设： Claude 已经非常聪明。对每一部分提出质疑：“它是否值得消耗这些 token？”

在添加新章节之前，先问它能否替换现有规则、移到 references/，或作为会话特定内容删除。

Skill 结构

将路由和决策保留在 SKILL.md 中；将确定性辅助逻辑放入 scripts/，将按需查看的细节放入 references/，将可复用输出放入 assets/。References 按需加载，且往往从未被读取，因此任何约束不可逆操作的规则——允许列表、禁止值、安全限制——即使读起来像细节，也要内联保留在 SKILL.md 中，只将其理由放在 references/ 中。参见 Skill Structure，包括被排除的文件。

创建流程

使用 Creation Process：选择原语和范围，提取可复用工作流，规划资源，实现，验证，并测试真实触发提示词。

重构顺序

改进现有 skill 时，使用以下顺序：

1. 删除过时或低价值的指引
2. 合并重复规则
3. 将冗长细节移到 references/
4. 最后添加真正缺失的指引

Frontmatter 与触发

使用最小可用的 frontmatter：name、description，以及仅在改变行为时才添加的可选字段。name 必须与文件夹一致，description 必须包含触发条件。

Frontmatter 细节与静默失败：references/common-pitfalls.md

SKILL.md 指南

保持 SKILL.md 精简：少于 150 行较好，超过 300 行必须拆分到 references。When to Use 以用户用语开头，仅保留必要工作流，并将冗长的示例 / schema / 配方移至 references。

详细审查标准：references/skill-review-checklist.md

迭代循环

1. 起草该 skill 并保存。
2. 找出最薄弱或最含糊的部分。
3. 收紧这些部分，然后总结该 skill 的产出物以及可尝试的示例提示词。

关键参考

使用 primitive choice、structure、creation、review checklist、bloat review 和 common pitfalls。structure gallery、workflows 和 output patterns 为可选示例。

完成标准

• 已确认请求的是一个 skill，而非其他 primitive
• 在创建文件前已确定范围
• 已创建 SKILL.md 且少于 150 行
• Frontmatter 包含 name + description 及触发条件
• 手动使用的 skill 具有 argument-hint
• 已刻意设置 user-invocable
• 仅当可选字段会改变行为时才添加
• 细节已移至 references/（渐进式披露）
• 自包含：不硬引用其他 skill / 工作区文件；环境特定值（路径、客户名称、租户 ID）已抽象
• 已通过审查清单