SuperAPI AI 工具集

update-agents-md

智能体与模型

查看项目

更新于 10-16 08:01

技能介绍

用途:在编辑 AGENTS.md 之前阅读并遵循,目标是把该文件保持短小、可快速浏览,只承载具约束力的跨领域规则。

主要能力与约束:AGENTS.md 有 600 行上限,每次编辑都要用 wc -l AGENTS.md 检查;若改动导致超限,须在同一次编辑中删除或迁移至少同等行数,不得先提交增长再等后续清理。不得设置大型目录,“Task-specific guidance”指针表保持 12 行以内,仅保留高价值条目,不得在 AGENTS.md 内长出第二个目录。需保护根 README 边界:如编辑改变了文档入口指引,README.md 须保持为 120 行以内的产品落地页,仅展示日常主力与特色演示能力,每项能力配可运行 CLI 命令与 https://dotnet-inspect.net/?w=... 同视图链接。需保护操作员模板:theme/status 提醒、tmux 命令与状态块、round report 及其调用规则必须原样直接保留在 AGENTS.md 中,不得为满足行数上限而删除、缩短为指针或迁移。

内容归属:AGENTS.md 只放几乎每个会话都需要的具约束力跨领域规则;机制、示例、边界情况表、理由与历史背景应放入 docs/、docs/design/、docs/runbooks/ 或 docs/templates/ 下的专门文档,并在 AGENTS.md 留简短指针。

修改流程:先记录基线 wc -l AGENTS.md;新策略只写规则本身;细节放归属文档并链接;确认受保护模板仍可直接使用;重新检查行数,超限则整节迁移;文档入口变化时检查 README.md 行数;提交前运行 npx markdownlint-cli AGENTS.md(及所编辑文档)。

超预算时按整节(而非逐词精简)迁移内容,绝不删除或合并标题;受保护模板不是迁移候选。验证命令:wc -l AGENTS.md(须 ≤600)、wc -l README.md(须 ≤120)、npx markdownlint-cli AGENTS.md。