SuperAPI AI 工具集

ai-config

编程与开发

查看项目

更新于 11-02 19:14

技能介绍

AI Config 是一个用于管理仓库中 AI 编程助手配置文件的技能。其目标是检测、创建、同步并检查配置漂移,且兼容用户已有的配置,不引入技能自有的状态文件。

用途 统一管理多种 AI 编程工具在代码仓库中的说明文件,避免各工具配置文件内容不一致,并发现配置文件与实际技术栈之间的偏差。

支持的配置文件 共享/通用:AGENTS.md(仓库根目录)。 Claude Code:CLAUDE.md(仓库根目录及子目录)。 GitHub Copilot:copilot-instructions.md(.github/),以及文件级 .instructions.md(.github/instructions/)。 Cursor:.mdc 规则(.cursor/rules/),旧版 .cursorrules(根目录)。 Gemini CLI:GEMINI.md(根目录)。 Cline:.clinerules(根目录)。 Windsurf:.windsurfrules(根目录)。

使用方式 启动时先扫描仓库中已有的配置文件,再根据情况决定模式:无配置则进入 init;有配置且参数指定新增工具则进入 add;参数为 check 或 drift 则进入相应检查;参数为 edit 则进入编辑;发现多个配置且无参数时,先做一次轻量跨配置同步检查,再询问用户意图;只有一个配置且无参数时,询问是更新、添加工具还是检查漂移。

主要模式 init:说明尚无配置,推荐以 AGENTS.md 作为可移植的起点;询问团队使用的工具(Copilot、Claude Code、Cursor、Gemini CLI、Cline、Windsurf 或其他);询问 shell 偏好、提交风格、确认行为和额外约定;确认文件列表后写入,并用哨兵注释包裹生成内容。 add:为尚未配置的新工具生成配置文件,读取已有配置提取偏好,预览差异并确认后写入。 check:按工具/框架、shell、提交风格、方法论、受限操作等维度跨文件比对,只标记明确冲突,不把“未提及”视为错误;对每处分歧询问以哪个为准,然后在哨兵块内更新。 edit:按用户提出的偏好变更,定位包含该偏好的文件,在哨兵块内更新,哨兵外内容需先询问,写入前展示全部变更预览。 drift:扫描 package.json、pyproject.toml、go.mod、Cargo.toml、ESLint/Biome/Ruff 配置、.tool-versions、.nvmrc、Dockerfile 等信号文件,提取运行时、linter、格式化器、测试运行器、包管理器,与各 AI 配置比对,并借助 git 判断变更时间,只标记比配置更新近的变化。第二遍做结构漂移检查:检查配置中引用的路径是否仍存在(中等级别),以及新出现但未被任何配置提及的目录(低级别)。

写入安全规则 生成内容始终放在 <!-- ai-config:generated:<section-name> --> 与 <!-- ai-config:end --> 之间;.mdc 文件使用 YAML 注释形式的哨兵。哨兵外内容未经用户明确许可不得修改。首次写入时把整个生成文件包在哨兵块内。抑制标记 <!-- ai-config:suppress <id> --> 由用户书写,不得删除。任何写入前都展示前后差异并取得确认。

与 repo-init 的衔接 可由 repo-init 传入预填上下文(tools、shell、commit_style、confirmation、extra、methodology、stack 等),已提供的项跳过对应提问,并告知用户哪些值来自预填,便于更正。

适用场景 需要同时维护多种 AI 编程助手说明文件的团队仓库;希望以 AGENTS.md 作为统一入口的新项目;技术栈变更后需要让 AI 配置保持一致的项目。

限制 只处理上述已知配置文件;不引入自有状态文件;检查时只标记明确矛盾或过时内容,不将省略视为漂移;不修改用户手写内容;所有写入均需确认。各项工具适配细节、漂移信号完整列表与提取规则需查阅技能内的参考文件,具体内容在此暂未提供。