SuperAPI AI 工具集

bootstrap-agents-md

智能体与模型

查看项目

更新于 10-16 07:24

技能介绍

用途:为仓库建立 AI 编码智能体(如 Cursor、Claude Code)的操作系统,提供单一、持续维护的工作契约。

主要能力:生成根入口文档 AGENTS.md 与 CLAUDE.md(后者为指向 AGENTS.md 的符号链接,或仅含“See AGENTS.md — single source of truth.”);生成根 CONTEXT.md 记录领域语言(术语表与决策);在 docs/agents/ 下生成 architecture.md、code-style.md、lessons-learned.md;在 docs/plans/ 下生成 README.md;生成 docs/release.md;在 .agents/skills/ 下创建 plan-mode 与 code-review 技能,并按需添加技术栈相关技能。

使用方式:先执行 Phase 0 收集证据,读取 package.json、锁文件、CI 配置、tsconfig、lint/format 配置、测试设置、现有文档与目录结构;若存在 docs/agents/skills-config.md 则先读取,避免重复询问已定决策。随后按顺序依据 references/ 中的模板撰写各文档,符号链接命令为 ln -sf AGENTS.md CLAUDE.md。最后执行验证:确认 AGENTS.md 中命令存在于 package.json、相对链接可解析、CLAUDE.md 内容一致、CONTEXT.md 术语均有依据、无与既有文档矛盾、AGENTS.md 约 100 行可一分钟内浏览。

适用场景:需要为仓库引入统一智能体工作规范的团队,尤其是已有部分 AGENTS.md 或 Cursor 规则、需要合并去重的项目。

限制:不得复制其他产品的架构,除非在本仓库中已验证;文档不得包含密钥或环境变量值,应引用 .env.example;优先准确简短而非冗长;需匹配仓库的 Markdown 风格;重跑时带生成标记的文件可更新,但用户或智能体新增的活内容须保留,无标记文件只能就地合并、不得覆盖或另建副本。