creating-agent-skills

name	creating-agent-skills
description	为当前仓库新增或更新技能时的统一工作流

Creating Agent Skills

当你要在这个仓库里新增或修改 skill 时，按下面顺序执行：

1. 先阅读 references/checklist.md，确认目录、frontmatter 和分层结构是否满足要求
2. 如果要写 SKILL.md，再阅读 references/frontmatter.md，确保入口信息足够轻量
3. 只有在需要模板或辅助脚本时，才创建 assets/ 或 scripts/
4. 修改后运行仓库根目录的校验脚本，确认引用与 frontmatter 一致

核心原则

• skills/ 是唯一事实来源
• SKILL.md 只放入口与流程，不堆长文
• 详细资料进入 references/
• 避免重复定义同一条规则

示例

如果你准备新增一个数据库相关 skill，先把创建流程写在 SKILL.md，再把 ORM、SQL、错误处理细节拆到 references/ 中，并在正文中明确写出读取触发条件。