shunk031-manage-agent-guidance

说明

阅读此 SKILL.md 后，请说：🧭 I read shunk031-manage-agent-guidance.

管理 Agent 指引

将每条持久指引保存在唯一的真实来源中，并通过轻量适配器提供。

工作流

1. 提出更改前，先阅读适用的指引。
2. 将请求的规则归类为用户级、仓库级、子树级、仅限任务、自定义 Agent 或技能指引。将请求中提到的文件名视为待验证的假设，直到更高级别的指令、受管理来源、符号链接、导入、包装器和适配器确认后再作定论。
3. 检查受影响的使用方，并搜索现有负责人。如果所有权或内容重叠情况不明确，请建立使用方映射；对于自包含的编辑，只需记录可能受影响的来源和读取方。
4. 编辑一个权威来源。将共享行为规则放在用户级，将仓库流程放在仓库级，将子树规则放在子树级，将可复用的专业流程放在现有技能中。保持适配器轻量，不要仅因措辞相似就重复规则。
5. 编辑前，说明关于范围、真实来源、现有所有权及任何尚未明确的使用方的证据。仅当没有适合的现有负责人，且流程内容足够丰富、可复用时，才创建技能。
6. 检查最终差异，确认没有范围不符、所有权重复、机密信息、临时事实或适配器偏差。运行受影响仓库的实际门禁；不要臆造钩子、跳过变量或模型门禁。

在范围、真实来源、现有所有权和受影响的使用方都确认前，不要起草或编辑。如果无法获得证据，请报告缺失的来源并提出调查方案，不要默认采用指定文件。

持久化质量

• 仅保留简洁、可执行且适用于类似情形的预防措施，并说明可复用的根因防护方法。
• 排除机密信息、特定任务事实、临时状态、事件叙述和未经验证的假设。
• 持久指引不得引用问题或 PR 编号、迁移跟踪状态或其他会过期的事实。指引文件会一直加载，但这些事实都有时限：问题会关闭，迁移会完成，而孤立的编号脱离跟踪系统后便无法解析，导致未来的读者既无法验证，也无法据此采取行动。过期事实应记录在问题跟踪系统或注明日期的研究笔记中。

指令迁移

对于实际迁移或移除，检查来源及其受机器约束的所有者，记录每条受影响规则的来源、目标位置、适配器或经批准移除的情况及其理由，并在更改后检查使用方。不要为常规编辑创建迁移记录，也不要删除未映射或未经批准的规则。

仓库验证

• 指明门禁前，检查受影响仓库当前的 Makefile、pre-commit 配置和 CI。
• 运行该仓库文档中规定的静态门禁，并保留必需的所有权检查；不要假设其他仓库的钩子 ID 或跳过变量也适用。
• 仅当任务和仓库明确要求时，才运行实时模型评估。不要用新框架替代缺失的门禁。

仓库配置

• 将仓库约定保留在根目录的 AGENTS.md 中；不要在其中重复用户级规则。
• 将根目录的 CLAUDE.md 设置为指向 AGENTS.md 的相对符号链接，而不是复制文件或导入存根。
• 将仓库本地技能保留在 .agents/skills/<name>/SKILL.md，并在需要时通过相对 .claude/skills 符号链接将其提供给 Claude。
• 将较长的共享自定义 Agent 指令保留在 ~/.agents/agents/<name>.md 中。在精简版 Claude 或 Codex 包装文件中保留特定工具的元数据，并让其指向共享源文件。
• 不要在公开指南中加入私有基础设施、凭据、内部端点和特定环境的启动配置。
• 在明确需要之前，不要引入 Markdown 解析器或生成器，将共享指令复制到 TOML 或 Markdown 中。