Community编程与开发github.com

SebastienElet/agent-skills

维护编码代理指令及其发现路径。在创建或修改 AGENTS.md、CLAUDE.md、代理规则或指令投影时使用。确保每当代理指引或其部署发生变化时使用此技能,即使请求仅提及一个代理。

agent-skills 是什么?

此技能专为需要维护编码代理指令体系、确保指令来源唯一且可发现的场景设计。它要求用户遵循共享维护策略,在修改指令内容、适配器、部署或验证流程之前应用。该技能支持所有主流代理平台(如 Claude Code、Codex 等),其核心步骤包括:完整阅读维护参考文档、检查现有指令层次结构与受影响的所有发现路径、选择一个规范来源并将特定代理位置作为投影或适配器、更新所有安装程序、生成文件、索引及验证屏障,最后独立验证每个受影响的代理投影。此外,技能明确指出了三个常见错误:将条件性指引放入始终加载的指令中(增加上下文成本)、将名称相同但语义不同的机制混为一谈(如 Claude Markdown 规则与 Codex 命令规则)、仅更新一个投影导致其他代理行为过时。通过强制保持单一规范来源、禁止在可兼容性垫片中使用条件规则、以及要求验证实际部署目标,该技能确保代理指令维护过程的严谨性与可靠性。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/SebastienElet/agent-skills/tree/HEAD/skills/agent-instructions

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

代理指令维护

概述

保持代理指引的范围明确、可发现,并源自单一规范来源。在修改指令内容、适配器、部署或验证之前,应用共享维护策略。

用法

在修改全局或项目指令、特定代理规则文件以及暴露这些规则文件的配置时使用此技能。例如:$agent-instructions add a Codex instruction source。

步骤

  1. 完整阅读 references/maintenance.md。
  2. 检查现有的指令层次结构以及受该更改影响的每个发现路径。
  3. 选择一个规范来源,并将特定代理位置保持为投影或适配器。
  4. 更新所有消费该来源的安装程序、生成文件、索引和验证屏障。
  5. 独立验证每个受影响的代理投影。

易错点

  • 将条件性指引放入始终加载的指令中——每个任务都会付出上下文成本;对于支持渐进式披露的代理,应将其作为技能暴露。
  • 将名称相同的机制视为等同——Claude Markdown 规则和 Codex 命令规则具有不同的语义;验证消费者发现契约。
  • 仅更新一个投影——另一个代理会静默地保持过时行为;枚举每个声明的消费者并测试其实际目的地。

约束

  • 为共享指令行为维护一个规范来源。
  • 切勿将条件规则作为兼容性垫片注入始终加载的指令文件中。
  • 除非检查了实际部署的目标,否则切勿报告投影处于健康状态。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相关技能