「1024节日快乐」Google Cloud Tech 分享了一套组织 Coding Agent 指令的方法：用 AGENTS.md、DESIGN.md、SKILL.md，分别管理项目约定、界面设计和具体任务流程。适合把团队反复输入的要求沉淀到代码仓库里。

① AGENTS.md：写清楚在这个项目里怎么工作。放项目结构、环境准备、构建与测试命令、修改边界。要求要具体，比如改完代码运行哪条检查、哪些生成文件不要编辑。顶层保持简洁，详细流程链接到对应 Skill。Google ADK 的 AGENTS.md 就采用了“核心组件简介＋详细架构 Skill 入口”的组织方式。

② DESIGN.md：同时记录设计数值和使用理由。用 YAML 保存颜色、字体、字号、间距、圆角等设计 token，用文字说明整体风格，以及这些值应该用在哪里。例如，强调色用于主要操作，次级色用于说明文字。精确数值保证一致性，文字说明帮助 Agent 在新增页面时延续设计意图。Google 的 DESIGN.md 仓库提供了格式规范与示例。[规范与示例](网页链接)

③ SKILL.md：把重复任务写成可复用步骤。例如部署到 Cloud Run、执行数据分析、按品牌口吻编辑文案。支持 Skills 的工具可以按需加载相关内容，减少把所有流程塞进常驻上下文的需要。Google 已公开覆盖云服务、数据分析等任务的 Skills，可作为编写参考。[Google Skills](网页链接)

④ 像维护代码一样维护这些文件。把规范提交到版本控制，随项目一起更新、审查。第三方 Skill 使用前先读内容，按软件依赖对待。文件的发现、加载和优先级仍取决于具体工具，不能只创建三个文件名就默认全部生效。

HOW I AI程序员1024