用途
agent-instructions 是一项用于编写和维护仓库指导文档的技能，覆盖 AGENTS.md、CLAUDE.md 以及 .agents/skills 目录。它适用于创建或编辑技能、决定指令应放在何处，以及维护跨任务约束与专门判断的场景。其核心理念是：指导文档应当保留未来智能体能够找到并应用的判断力，而技能的价值来自知识、偏好或反复出现的失败经验，而非指令的数量。
主要能力
- 帮助确定指令的归属者：当意图相同时更新已有归属者，当技能提供可独立使用的连贯能力时创建单独技能，并合并或删除区分成本高于收益的指导。
- 区分不同文档的职责：跨任务约束放在 AGENTS.md，专门判断放在技能中，架构或决策历史放在相关 README 或 ADR 中。
- 指导如何为判断力写作：陈述前提并将指令与原因关联，给出标准与边界，仅在顺序影响正确性时规定步骤。
- 规范技能描述：在 frontmatter description 中描述能力及应选择该能力的用户意图，为可能的近似场景添加排除项。
- 遵循仓库约定：项目技能位于 .agents/skills/<name>/SKILL.md，使用小写连字符命名和包含 name 与 description 的 YAML frontmatter。
- 为面向 Claude 的技能创建相对同级链接，并随技能更新或移除。
使用方式
该技能以指导原则的形式提供，而非可执行工具。使用时，开发者依据其原则决定指令的放置位置和写作方式。仓库约定包括：项目技能放在 .agents/skills/<name>/SKILL.md；为 Claude 准备的技能需从仓库根目录创建相对同级链接，命令为：
ln -s ../../.agents/skills/<name> .claude/skills/<name>
仅面向 Codex 的技能不创建 Claude 链接。CLAUDE.md 文件是导入同级 AGENTS.md 的垫片。持久的个人指导应放在受跟踪的 dotfiles 仓库中，而非宿主管理的系统技能安装中。导入指导时，应先检查其脚本、依赖、外部操作和假设，再适配本地约定，并说明工作流所需的工具或凭据。
适用场景
- 创建或编辑技能时。
- 决定某条指令应归属于 AGENTS.md、技能、README 还是 ADR 时。
- 维护跨任务约束与专门判断时。
- 检查技能名称、位置或发现元数据变更后的 frontmatter 与宿主发现时。
- 调查技能选择或行为、比较版本或需要改进证据时。
限制
该技能为写作与组织指导，不提供自动化执行能力。指令本身不能授予访问权限。并非每次编辑都需要安装 CLI 或审计整个库；散文修正本身不需要这些步骤。评估与组合诊断并非每次编辑的必需通过项。关于收费、价格、平台支持等具体信息，资料中暂未提供。