用途
aicfg 是针对 AGENTS.md 生态的命令行工具，目标是解决 AI 编程工具配置分散的问题。每个 AI 编程工具都有自己的配置格式（如 CLAUDE.md、.cursorrules、copilot-instructions.md、GEMINI.md），分别维护容易产生规则过期、指令互相矛盾、复制粘贴导致的偏差。aicfg 的做法是把 AGENTS.md 作为单一事实来源，让各工具专属配置文件变成指向 AGENTS.md 的简短垫片（shim）文件，做到“一处编辑，处处生效”。
主要能力
- init：检测项目技术栈，生成 AGENTS.md 以及各工具专属 shim 文件（CLAUDE.md、.cursorrules、GEMINI.md、.github/copilot-instructions.md 等）。支持 10 种技术栈：go、rust、node-express、nextjs-typescript、python-fastapi、monorepo、microservices、fullstack-nextjs、enterprise-python、ci-cd-integration、team-sharing。不会覆盖已有的 AGENTS.md 或 README。
- shim 生成：可基于已有 AGENTS.md 生成缺失的垫片文件，在已有项目上运行也安全，不会覆盖现有文件。
- 校验（validate）：按最佳实践检查 AGENTS.md 的质量，检查项包括项目概览、构建命令、编码风格、范围边界、错误处理、测试、安全、Git 工作流以及内容长度是否充足。
- 完整配置审计：对 AGENTS.md 及所有垫片文件进行整体审计。
- 代码库上下文打包：将代码库上下文打包，供 AI 使用。
使用方式
基础命令为：aicfg init [stack]，其中 stack 为技术栈名称。init 会生成完整的智能体规则（AGENTS.md，作为单一事实来源），以及若干 shim 文件：CLAUDE.md、.cursorrules、GEMINI.md、.github/copilot-instructions.md，这些垫片文件内容指向“Read AGENTS.md”。
仓库还提供浏览器内试用入口：可在浏览器中选择技术栈，预览生成的 AGENTS.md 和 shim 文件，无需安装。
适用场景
- 团队或个人在多个 AI 编程工具之间使用同一套规则，希望统一维护。
- 项目已采用 AGENTS.md，需要为新增工具快速补充垫片配置。
- 需要检查 AGENTS.md 是否符合最佳实践，或对全部配置文件做整体审计。
背景与限制
AGENTS.md 是由 Linux Foundation 管理的 AI 智能体配置开放标准，被 Claude Code、Cursor、GitHub Copilot、OpenAI Codex、Gemini CLI、Windsurf、Devin、Aider 等 20 多个 AI 编程工具支持。资料提到一项普林斯顿研究（OpenAI Codex，跨 10 个仓库 / 124 个已合并 PR）测得：存在 AGENTS.md 时，中位运行时间减少 28.6%，中位 token 减少 16.6%，原因是智能体无需再探索目录结构、猜测构建/测试命令。目前已有 60,000 多个 GitHub 仓库包含该文件。
aicfg 自身也使用 aicfg init 进行配置。工具以 MIT 许可证发布，永久免费。有关安装命令、支持的完整工具列表及最新功能细节，资料中暂未提供。
