SuperAPI AI 工具集

improve-agents-md

智能体与模型

查看项目

更新于 10-15 21:08

技能介绍

用途:改进或从零引导项目的智能体指令文件(AGENTS.md 与 CLAUDE.md),解决代理因文件过长、内容与当前任务无关而整体忽略项目规则的问题。适用于用户要求清理、缩短、审计或重写 CLAUDE.md/AGENTS.md,代理反复无视项目规则,或准备接入新代理并检查指令质量时。

主要能力:两个手段。一是精简,删除可由 linter、formatter、pre-commit 钩子强制的内容,删除可从现有代码模式推断的内容,删除含糊口号。二是条件化包裹,把领域指导放进 <important if="..."> 块,条件须窄而具体。基础上下文(项目身份一句话、目录地图、技术栈)保持裸文本置于顶部,命令统一放一个条件块并保留全部命令。

文件解析:以 CLAUDE.md 为磁盘规范文件,AGENTS.md 作为指向它的符号链接。启动时检查根目录(或子目录)两文件:仅有 CLAUDE.md 则编辑它并可选创建 AGENTS.md 链接;仅有真实的 AGENTS.md 则询问是否改名并建链接;一方为链接则编辑真实文件;两者均为真实文件则询问规范文件;均不存在则询问引导或中止。始终用 ls -la 确认符号链接。

交互流程:解析目标文件、读取并按基础/命令/条件规则/领域段/lint 领域/含糊口号/过期代码片段分类、就争议删除项批量询问、先展示含条件的结构大纲、备份原文件(cp CLAUDE.md /tmp/CLAUDE.md.before-$(date +%s))、重写并给出差异摘要、报告 before/after 的字符/行数/KB/估算词元并给出精简度判定(<500 词元 Lean、500–1000 Good、1000–2000 Fat、>2000 Bloated)、可选创建符号链接 ln -s CLAUDE.md AGENTS.md 并附后续操作。

限制:资料未提供该技能的安装命令、收费或价格信息,均暂未提供。使用需在 Claude Code 环境内运行。判定阈值与词元估算为启发式,需结合 monorepo 等情况判断,不可机械套用。