SuperAPI AI 工具集

refactor-agents-md

编程与开发

查看项目

更新于 10-16 03:39

技能介绍

用途:在准备重构或精炼用户级、项目级 AGENTS.md 时使用。核心判断是 AGENTS.md 的每一行都会进入其作用范围内的每次 Codex 会话,因此必须值得占用这部分注意力。

主要能力:先确定目标文件,可为 $CODEX_HOME/AGENTS.md(未设置时默认 ~/.codex/AGENTS.md)、当前项目根 AGENTS.md,或从项目根到当前工作目录路径上的嵌套 AGENTS.md。随后审计每条指令并给出唯一结论:contradiction(与其他适用指令冲突,记录双方及来源)、delete(通不过 no-op 测试,如冗余默认、含糊表述、“写干净代码”类套话)、demote(仅适用更窄目录或任务,需指定目标,如更近的嵌套 AGENTS.md、技能或链接文档)、rewrite(范围与含义正确但表述不符合提示指南)、keep(原样即值得常驻加载)。

判定标准:用户级保留项须跨项目表达偏好或约束,条件性工具与环境规则在触发可跨项目复现时合格;项目或嵌套级保留项须管辖目标目录子树,可保留项目上下文、Codex 易猜错的命令、领域概念、约束与非显然陷阱,删除对代码的复述和易变清单。

使用方式:按请求匹配审计范围;重构或编辑经授权后执行,保留明确的审查边界,仅在存在未解决矛盾或超出授权的行为变更时询问。提出改写方案及删除、降级清单(含目标位置)后再确认。可用的 Codex 环境使用 request_user_input,否则提一个简洁问题。移动或删除前先搜索引用并更新指针,最后检查 diff 是否保留意图、解决冲突、目标可达。

GPT-6 相关检查:按使用目标文件的模型判断冗余默认;把无条件读文档要求改为指向具体任务的指针;用明确权限与停止条件替代不必要的审批门槛;说明用户指令优先于技能指南;直接说明期望长度与结构;说明何时使用子代理及限制;按改动匹配验证,避免为低影响编辑新增测试。

限制:官方未提供具体安装命令、平台、收费或价格信息;引用链接(如 OpenAI 与 ChatGPT 文档)指向外部指南,其内容不在本资料中。