SuperAPI AI 工具集

init-or-refactor-agents-md

编程与开发

查看项目

更新于 10-15 23:57

技能介绍

用途:把仓库里分散的代理指令文件(AGENTS.md、CLAUDE.md、CODEX.md、.cursorrules 等)整合为一份简短、高信号的规范 AGENTS.md。

主要能力:读取现有指令文件,列出冲突及来源并请用户裁决;按删除、yagni、工具噪音、测试作秀、结构等类别剪除冗余规则,保留仓库特有、安全关键或屡次被违反的规则;汇总分支、提交、PR、评审、发布、部署规则,确认采用直接主干、分支/PR 或用户指定流程;输出简洁的 AGENTS.md 草稿,经确认后写入并删除其他已合并的指令文件。

使用方法:按工作流执行,先读后剪再拟稿;写前展示来源、冲突、Git 选择、草稿与带标签的删除项,取得确认后落盘。除明确要求外,不创建工具专属指令文件。

目标策略(资料明确给出):测试多属债务,仅保留能捕获真实回归、公共接口契约或关键不变量(安全、权限、兼容性、并发、迁移、协议、数据丢失)的测试;用最廉价的检查验证变更,缺陷应尽量先复现;不测私有辅助函数、框架或类型保证、等价用例;仅在系统边界打桩;不得为通过变更而删除或弱化失败测试;未经要求不引入单元测试先行 TDD、覆盖率目标、测试专用 API、fixture 脚手架或 BDD 工具;加代码前优先移除需求、复用现有代码与配置、使用标准库或已装依赖,最后才加抽象与依赖;加依赖前比较可信替代方案并评估适配、许可证、维护与安全,请求批准;按垂直切片推进并保持可评审;有风险或破坏性变更前先询问。

限制:未提供该技能的安装命令、依赖环境、代理平台兼容性与具体可用范围,这些事实暂未提供。