SuperAPI AI 工具集

agent-setup-maintenance

智能体与模型

查看项目

更新于 10-15 23:48

技能介绍

用途:在修改仓库共享智能体配置时使用该技能。它面向 Langfuse 仓库中 .agents/ 下的仓库自有配置,帮助协作者按统一约定编辑 AGENTS 文件、共享技能与 .agents/config.json,避免直接改动各工具生成的产物。

主要能力与工作流:只编辑 .agents/ 下的规范文件,不改动生成的 provider 输出;根目录 AGENTS.md 应保持为指向 .agents/AGENTS.md 的符号链接,文件夹说明直接写在 AGENTS.md 中,不生成 CLAUDE.md 配套文件;.claude/、.cursor/、.codex/、.vscode/、.mcp.json 等目录视为生成的发现面,除非工具确有专属特性需求;根 AGENTS.md 保持简洁,详细或条件性流程移入共享技能或各包 AGENTS.md;新增或修改共享技能时以 SKILL.md 为入口。修改生成输出或 provider 发现行为前,需检查 scripts/agents/sync-agent-shims.mjs;涉及安装期同步行为时检查 scripts/postinstall.sh 与 package.json;新增或编辑共享技能可先用 ../skill-creator/SKILL.md,再套用本技能中的仓库检查。

验证要求:更改共享智能体配置后运行 pnpm run agents:sync 与 pnpm run agents:check;同步行为变化时运行 node --test scripts/agents/sync-agent-shims.test.mjs;安装期行为变化时运行 pnpm run postinstall,并对改动脚本运行针对性测试。

限制与约束:pnpm install 可能在缺少完整源码树的环境中执行,Docker 构建中 Turbo 的裁剪安装阶段可能在 scripts/ 与 .agents/ 尚未就绪前触发根 postinstall,因此安装期逻辑需在缺少所需仓库文件时干净跳过。设计上优先单一仓库自有来源而非重复的 provider 专属文件,尽量保持工具中立;仅当某 provider 要求固定发现路径或无法用共享模型表达的功能时,才把专属文件纳入版本控制。共享配置行为有实质变化时,需在同一 PR 内更新 README.md 与面向贡献者的文档。该技能不提供具体代码示例之外的实现细节,缺失事实暂未提供。