name: agents-md description: 当用户要求“创建AGENTS.md”、“更新AGENTS.md”、“维护代理文档”、“设置CLAUDE.md”或需要保持代理指令简洁时,应使用此技能。指导发现本地技能并强制执行最小化文档风格。
维护AGENTS.md
AGENTS.md是面向代理的规范文档。保持简洁——代理能力强,不需要手把手指导。
文件设置
- 在项目根目录创建
AGENTS.md - 创建符号链接:
ln -s AGENTS.md CLAUDE.md
写作前
发现要引用的本地技能:
find .claude/skills -name "SKILL.md" 2>/dev/null
ls plugins/*/skills/*/SKILL.md 2>/dev/null
阅读每个技能的前言以了解何时引用它。
写作规则
- 标题 + 项目符号 - 无段落
- 代码块 - 用于命令和模板
- 引用,不重复 - 指向技能:“使用
db-migrate技能。参见.claude/skills/db-migrate/SKILL.md” - 无填充 - 无介绍、结论或客套话
- 信任能力 - 省略明显上下文
- 技能更新 - 创建或更新技能时始终使用
/skill-creator
必需部分
包管理器
仅工具和关键命令:
## 包管理器
使用 **pnpm**:`pnpm install`、`pnpm dev`、`pnpm test`
提交归属
始终包括此部分。代理应使用自己的身份:
## 提交归属
AI提交必须包括:
Co-Authored-By: (代理模型的名称和归属署名)
示例:`Co-Authored-By: Claude Sonnet 4 <noreply@example.com>`
关键约定
代理必须遵循的项目特定模式。保持简短。
本地技能
引用每个发现的技能:
## 数据库
使用 `db-migrate` 技能进行模式更改。参见 `.claude/skills/db-migrate/SKILL.md`
## 测试
使用 `write-tests` 技能。参见 `.claude/skills/write-tests/SKILL.md`
可选部分
仅在真正需要时添加:
- API路由模式(显示模板,不解释)
- CLI命令(表格格式)
- 文件命名约定
反模式
省略这些:
- “欢迎来到…”或“本文档解释…”
- “你应该…”或“记住要…”
- 从技能复制的内容(改为引用)
- 明显指令(“运行测试”、“编写干净代码”)
- 解释原因(只说是什么)
- 长篇幅段落
示例结构
# 代理指令
## 包管理器
使用 **pnpm**:`pnpm install`、`pnpm dev`
## 提交归属
AI提交必须包括:
Co-Authored-By: (代理模型的名称和归属署名)
## API路由
[模板代码块]
## 数据库
使用 `db-migrate` 技能。参见 `.claude/skills/db-migrate/SKILL.md`
## 测试
使用 `write-tests` 技能。参见 `.claude/skills/write-tests/SKILL.md`
## CLI
| 命令 | 描述 |
|---------|-------------|
| `pnpm cli sync` | 同步数据 |