skills之audit技能:一键生成AGENTS.md,给AI编码Agent装上项目上下文记忆

📅 发布时间:2026/10/11 19:56:33
skills之audit技能:一键生成AGENTS.md,给AI编码Agent装上项目上下文记忆
【免费下载链接】skillsAgentic Development skills behind the JS Mastery workflow项目地址https://gitcode.com/gh_mirrors/skills45/skills点击查看免费下载skills 是一套面向 AI 编码 Agent 的工程工作流技能集合其中的audit 技能能一键扫描你的代码库、自动写出AGENTS.md上下文文件让 Claude Code、Codex、Cursor 等 Agent 无需你反复口述就能记住项目的技术栈、命令与编码规范。下面带你彻底搞懂 audit 是怎么给 AI 装上项目上下文记忆的。为什么 AI 编码 Agent 需要项目上下文用 AI 写代码时最头疼的一点是每次开新会话Agent 都像失忆不知道你用什么框架、怎么启动、遵循什么规范只能瞎猜或等你手动粘贴说明。skills 的思路是把项目知识写进文件、而不是留在聊天里。audit正是干这件事的上下文引导员它读懂你的真实代码把技术栈、常用命令、编码规则沉淀成一份所有 Agent 都能读的AGENTS.md。会话清空、换人接手这些知识都还在仓库里。 相关文档docs/workflow-guide.md 用大白话讲清了整套工作流适合想一次看全的新手。audit 如何一键生成 AGENTS.md运行一次/audit技能会先做一段预检Pre-flight判断你属于哪种项目再走对应的生成模式。核心逻辑写在 skills/audit/SKILL.md。第 1 步识别项目类型audit 不靠文件数量瞎猜而是综合多个信号判断全新项目greenfield刚搭好脚手架、还没有真正的功能代码存量项目brownfield有真实代码和提交历史Monorepo检测到pnpm-workspace.yaml、turbo.json等标记它还会识别一个关键信号——工作流已选定技术栈但还没有根AGENTS.md即docs/specs/里已有架构 spec。这种情况下 audit 会把它当成新脚手架而非老代码库从而继续向你问编码规范避免误判。第 2 步按需生成根目录 嵌套 AGENTS.mdaudit 生成两层文件根AGENTS.md记录全局规则保持精简建议 60 行以内嵌套area/AGENTS.md只给确实有不同规范的重要区域写避免每个文件夹都塞一份同时它会为每个AGENTS.md配一个薄薄的CLAUDE.md内容只有一行指向AGENTS.md的导入保证只有一份真实来源、不会出现两份内容各走各的。AGENTS.md 里到底写了什么audit 写出的根AGENTS.md包含几个固定板块完整模板见 skills/audit/agent-prompt.md板块内容## Stack语言 / 运行时、框架、核心依赖、包管理器## Build approach项目的默认构建策略Tracer Bullet、Skateboard 等## Commands安装、启动、构建、测试等日常命令## Rules全项目适用的编码规范## Agent skills已安装的 Agent Skills 与 MCP 服务## Context files指向各嵌套AGENTS.md的入口这样下一个技能/develop、/architect等一进来就能读到这个项目长什么样、该按什么规矩写代码。4 种生成模式从空项目到存量代码库audit 通过 skills/audit/modes/ 下的四个模式文件覆盖所有常见场景greenfield空项目先向你问清编码规范与工具链再播种根AGENTS.md。规范预设可选四套Clean Architecture、Functional、DDD、SOLID OOP分别对应 patterns/clean-architecture.md、patterns/functional.md、patterns/domain-driven.md、patterns/solid-oop.md。whole-repo存量全库扫一遍仓库判断哪些知识该放全局、哪些该放区域写好根 嵌套文档。area单区域/audit src/auth只深入某个目录补上该区域的专属文档。gap-fill查漏补缺已有AGENTS.md时只补真正缺的东西绝不重写。只在新增、绝不覆盖给上下文记忆上保险audit 有几条硬规则保证它不会糟蹋你已经整理好的内容绝不覆盖已存在的AGENTS.md——它可能是你或别的工具手写的缺的只补要改的只提建议PROPOSED_ADDITIONS。文档与代码打架时只上报、不自动改——遇到文档说的和代码不一致它会列出来交给你决定。每个文件末尾打上 drafted by 标记——让后续运行能分清哪些是工具写的、哪些是你手写的。这套防御式写入正是项目上下文能长期保持可信的关键。audit 在整条工作流中的位置audit 不孤立工作它写出的AGENTS.md是所有后续技能的地基/scope → /audit → /architect → /develop → /check → /test → /document → /sync存量项目先跑/audit让每个技能都先读懂你的项目再规划下一个功能。全新项目先/scope、/architect定好技术栈并搭好脚手架再跑/audit读真实项目。之后每次改动收尾用/sync把AGENTS.md和代码重新对齐。完整流程可参考 README.md 的 Where to start 与 docs/workflow-guide.md。安装并运行 audit 技能用npx skills一行命令安装选你自己的 Agent# Claude Code装进 .claude/skills重启后生效 npx skillslatest add JavaScript-Mastery-Pro/skills -a claude-code # 通用 .agents/skillsCodex 等其他 Agent 直接读取 npx skillslatest add JavaScript-Mastery-Pro/skills装好后在 Agent 里输入/audit即可。它会自动判断项目类型、生成AGENTS.md最后给出报告发现了什么、写了哪些文件、还有哪些只是提了建议。快速上手清单 装好 skillsnpx skills add JavaScript-Mastery-Pro/skills在 Agent 中运行/audit查看生成的根AGENTS.md与嵌套文档跑完一个功能后用/sync让上下文保持最新把 skills 目录提交进仓库让全团队共享同一套上下文写在最后 audit 的本质是把你脑子里的项目知识变成仓库里所有 Agent 都能读的文件。它只做一件事把上下文写好绝不越权替你做决策。有了这份项目上下文记忆后续的develop、check、test才能真正按你的规矩干活——这正是 skills 整套工作流跑得稳的底气。赞分享【免费下载链接】skillsAgentic Development skills behind the JS Mastery workflow项目地址https://gitcode.com/gh_mirrors/skills45/skills点击查看免费下载相关推荐awesome-seedance Skills一条命令安装:给AI编程Agent装上77个AI视频提示词技能awesome seedance Skills一条命令安装:给AI编程Agent装上77个AI视频提示词技能 awesome seedance 是一个证据驱动的Wand-Enhancer 本地补丁如何解锁 WeMod 专业版功能一份完整实测教程Wand Enhancer 本地补丁如何解锁 WeMod 专业版功能一份完整实测教程 Wand Enhancer 是一款开源的 WeMod 本地补丁工具通过桌面应用前端Hindsight Coding Agents 集成指南给 18 种编程 Agent 装上会学习的项目记忆Hindsight Coding Agents 集成指南给 18 种编程 Agent 装上会学习的项目记忆 导读 本文基于 Hindsight 仓库中的 co人工智能AI AgentAgent 记忆MCP 服务创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考