代理文档维护Skill agents-md

此技能用于创建和维护AGENTS.md文件,确保代理文档简洁高效,通过发现本地技能并引用,指导代理操作,避免冗余文档。关键词:代理文档、技能管理、文档维护、AGENTS.md、CLAUDE.md、最小化文档。

DevOps 0 次安装 0 次浏览 更新于 3/17/2026

name: agents-md description: 当用户要求“创建AGENTS.md”、“更新AGENTS.md”、“维护代理文档”、“设置CLAUDE.md”或需要保持代理指令简洁时,应使用此技能。指导发现本地技能并强制执行最小化文档风格。

维护AGENTS.md

AGENTS.md是面向代理的规范文档。保持简洁——代理能力强,不需要手把手指导。

文件设置

  1. 在项目根目录创建 AGENTS.md
  2. 创建符号链接: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` | 同步数据 |