SuperAPI AI 工具集

agents-md

智能体与模型

查看项目

更新于 10-15 21:08

技能介绍

用途:根据工作区中的 *.code-workspace 文件,生成工作区根级 AGENTS.md 与按需 rules/ 规则文件,作为 Codex CLI、Claude CLI、Antigravity CLI、Cursor CLI、Opencode CLI 和 GitHub Copilot CLI 的共享操作说明来源;也可在仅有同步需求时,利用本地 Compose 证据同步已有项目的运行时块。

主要能力:扫描每个工作区文件夹,按 app-root 清单与锁定文件做技术栈探测,构建每文件夹一行的 Project Matrix(| Project | Path | Stack |);按 shipped 模板逐字节生成 AGENTS.md 和 rules/<name>,只填文件映射指定的括号槽位;检查并报告竞争性指令文件;对已有文件按标记判断生成、刷新或只做经批准的合并;保持 PROJECT-CODE(按 Path 匹配)稳定并保留用户编辑;检查生成文件不含会话数据(日期、对话引用、机器本地绝对路径)。

必要用法与限制:目标根必须包含一个 *.code-workspace 文件;不存在时应停止且不生成,并提示用户在含该文件的文件夹重跑。存在多个时先询问用哪一个。绝不创建或编辑 CLAUDE.md 或 GEMINI.md,也不从它们取规则。不读取或复制智能体自身的全局/用户指令文件。默认模式生成或刷新根文件及其按需文件;仅请求项目运行时同步时进入 runtime-only 模式,跳过根生成。生成文件首行为版本标记。迁移(docs 到 specs、CONTEXT 到 glossary 重命名)须先询问,拒绝或无回应则保持原路径。写入前重新读取目标;若自批准后已变更,需重新展示 diff。

适用场景:需要为多项目工作区集中维护统一智能体指令、规则与技术栈矩阵,或在本地 Compose 环境中同步既有项目运行时说明的仓库。限制:缺失的工作区文件会导致不生成;部分节仅在发现相应证据时输出;迁移与覆盖需明确批准。