jh-create-skill

结构

文件结构

skill-name/
├── SKILL.md
└── scripts/          # optional

将每个步骤、规则和示例都放在 SKILL.md 中。不要添加其他同级文档。

Frontmatter

---
name: your-skill-name
description: Brief high-level description of what this skill does.
disable-model-invocation: true
metadata:
  dependencies: other-skill
  dependents: downstream-skill
---

• name： 使用 kebab-case，最多 64 个字符，且只能包含小写字母、数字和连字符。
• description：用一个句子概括该技能的作用，概述要保持高度抽象。不要包含该技能的工作方式、调用时机或触发词等具体信息。
• metadata：
  • dependencies： 此技能要求 Agent 阅读并遵循的技能（**`skill-name` skill**, **`skill-name`**，或指向 skill-name/SKILL.md 的链接）。仅限技能之间的依赖，不包括钩子或子路径。
  • dependents： 反向依赖。确保两边保持同步。
  • 用逗号分隔 name 值。省略空字段。
  • 除非正文明确提及某个技能，否则不要根据产物名称或共用工具推断依赖关系。

内容

阅读 writing-for-agents 技能并遵循其中的要求——此技能仅涵盖技能专属的编写规范。

• 不要包含任何形式的标题。不要有标题、描述、起始部分、引言或前言。
• 仅当正文要求 Agent 遵循某个技能的工作流时，才将其列入 dependencies；孤立的事实或规则应直接写在此处。
• 列出某项技能后，应从正文中删除该依赖技能已涵盖的步骤或规则，不要重复说明。

面向任务，而非单次运行

技能应说明 Agent 如何完成一类任务，而不是记录你或 Agent 已经完成的某次会话。

放入技能

• 有序的工作流和范围限制（要做什么、跳过什么）。
• Agent 若不遵守就会出错的硬性规则（环境陷阱、“绝不停止 remsh”、审批关卡）。
• 在工作流属于其他技能职责时，指向相应技能。

不要放入

• 仅适用于单个功能的流程，除非技能名称和描述明确限定为该功能。
• 复制以往运行中的内容：示例消息正文、TypeID、SQL、Oban worker 名称、API 路由、Redis 键、“取消任务然后重置状态”之类的操作步骤，以及类似的一次性脚本。
• Agent 可在运行时从用户请求、测试或代码库中获取的细节。

运行时，Agent 会读取用户的请求和代码库以获取具体信息。即使这些具体信息发生变化，技能内容也应保持稳定。