关于 agent-setup-maintenance
agent-setup-maintenance 是用于维护仓库共享 Agent 配置的技能，规定了权威源文件、生成的 shim、安装时行为、文档和验证流程。
主要功能
- 01在 .agents/ 中维护权威文件
- 02管理生成的 Agent 发现入口
- 03尽量保持共享指引与工具无关
- 04兼顾裁剪后的 Docker 安装阶段
- 05运行同步、检查和针对性测试
适用场景
- 01修改共享技能或 Agent 指引
- 02调整 Agent shim 生成行为
- 03更改安装时的配置同步
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/agent-setup-maintenance确认已加载。
详细介绍
Agent 设置维护
当你更改仓库的共享 Agent 设置时，请使用此技能。
从这里开始
- 阅读
../../README.md了解共享配置和 shim 模型。 - 阅读根目录
../../AGENTS.md了解仓库级预期。 - 添加或编辑共享技能时，使用
../skill-creator/SKILL.md，然后应用此技能中 仓库特定的检查。 - 在更改生成的输出或提供方发现行为之前，检查
../../../scripts/agents/sync-agent-shims.mjs。 - 在更改安装时同步行为时，检查
../../../scripts/postinstall.sh和../../../package.json。
工作流
- 编辑
.agents/下的规范文件，而不是生成的提供方输出。 - 保持根目录
AGENTS.md作为指向.agents/AGENTS.md的符号链接。将文件夹 说明直接写入AGENTS.md；不要生成CLAUDE.md配套文件。 - 将
.claude/、.cursor/、.codex/、.vscode/和.mcp.json等工具特定目录视为生成的发现界面，除非该工具 需要真正工具特定的功能。 - 保持根目录
AGENTS.md简洁。将详细或条件工作流移到 共享技能或包AGENTS.md文件中。 - 将开发者反馈视为学习循环：当任务揭示出持久的
仓库约定、反复出现的陷阱、可复用工作流或验证
模式时，更新最小的相关
AGENTS.md或共享技能。 - 添加或更改共享技能时，保持
SKILL.md作为入口点；不要 在根目录AGENTS.md中添加逐个技能的链接。 - 当共享设置行为发生重大变化时，在同一 PR 中更新
README.md和 面向贡献者的文档。
Docker / 安装时约束
pnpm install运行的环境可能不包含完整的仓库源码 树。- 在 Docker 构建中，Turbo 的裁剪安装阶段可能会在镜像中
scripts/和.agents/可用之前运行根目录postinstall。 - 在这些裁剪上下文中保持安装时 Agent 设置逻辑健壮：当所需的仓库自有文件不存在时，干净地跳过。
必需验证
更改共享 Agent 设置后运行：
pnpm run agents:syncpnpm run agents:check- 当同步行为发生变化时，运行
node --test scripts/agents/sync-agent-shims.test.mjs
在相关时运行额外验证：
- 当安装时行为发生变化时，运行
pnpm run postinstall - 为你更改的任何脚本运行针对性测试
设计规则
- 优先使用一个仓库自有的唯一事实来源，而不是重复的提供方特定文件。
- 尽可能保持共享设置工具中立。
- 仅当提供方需要固定发现路径或无法通过共享 设置模型表达的功能时，才将提供方特定文件保留在源代码控制中。
评论
支持 Markdown