Agent Operating Kit：与AI编程助手协作的文档与流程模板集

Agent Operating Kit（AOK）是一套帮助开发者与AI编程助手高效协作的文档模板和流程规范集合，旨在解决AI辅助开发中的常见运营问题（如文档不一致、流程混乱、上下文庞大等）。其核心价值在于通过精简的文档结构、标准化工作流和组件化选择，减少AI助手的上下文消耗，提升协作一致性，并保护现有项目资产。

随着Claude、Cursor、Codex等AI编程助手普及，团队遇到的运营问题包括：

1. AI不清楚规划文档的实施起点
2. 任务缺乏一致流程
3. AI生成的文档与代码偏离，文档间失去一致性
4. AGENTS.md或规划文档过于庞大，小任务消耗大量上下文
5. 现有项目引入AI规则时担心丢失重要细节

AOK应运而生，它不是更大的提示词，而是可复用的文档和工作流模板集合，固化AI协作最佳实践。

核心理念

1. 精简始终读取文档：根目录AGENTS.md控制在50-100行，详细内容移至独立文档按需读取
2. 组件化选择：按需选择组件，避免不必要复杂度
3. 保护现有资产：应用时先读取现有文档，修改需用户批准
4. 减少默认上下文消耗：成功标志是日常任务的默认上下文减少

核心组件

• 根目录AGENTS.md：AI始终读取，含项目概述、常用命令、验证流程、文档路由
• DESIGN.md：UI/前端设计基准（颜色、字体、布局等）
• 文档地图与治理：.agents/INDEX.md索引工作流，定义权威来源和变更审批规则
• 工作流文档：.agents/workflows/*.md（功能开发、Bug修复等标准化步骤，基于Superpowers框架）
• 决策记录与状态跟踪：ADR、当前状态、版本历史、工作日志

新项目应用流程

1. 用户请求应用AOK
2. AI读取对应语言的agentOperatingKit.md
3. 展示可选组件清单
4. 用户选择组件
5. AI读取选定模板
6. 生成方案，经用户批准后实施

现有项目迁移原则

1. 先读取现有文档
2. 识别信息分布
3. 提出迁移方案（说明修改/移动/删除的文件）
4. 获取用户批准
5. 渐进式迁移（分阶段应用组件）

场景一：个人项目初始化

小明用AOK精简版：根目录AGENTS.md（项目概述、常用命令、测试流程），不使用工作流，减少上下文消耗

场景二：团队项目规范化

5人团队用完整版：统一AGENTS.md、标准化工作流、DESIGN.md、ADR文档，确保任务执行一致

场景三：现有项目AI化改造

2年项目渐进式迁移：

1. 第一阶段：创建精简AGENTS.md
2. 第二阶段：引入新功能工作流
3. 第三阶段：整合规范到DESIGN.md 过程遵循“先读取→分析→迁移”原则

AGENTS.md编写建议

1. 保持精简，仅含AI始终需知信息
2. 明确文档路由规则
3. 包含任务验证步骤
4. 纳入版本控制

工作流使用建议

1. 只为重复任务创建工作流
2. 保持可组合性
3. 设置关键检查点
4. 明确输出要求

文档治理建议

1. 定义权威来源文档
2. 建立AI文档变更审批流程
3. 定期审查文档一致性
4. 用ADR记录重要决策

AOK的核心价值：

1. 减少AI上下文消耗
2. 提升协作一致性
3. 保护现有项目资产
4. 灵活可扩展（组件化选择）

展望：随着AI编程助手普及，高效协作将成重要技能，AOK提供实践方法论。建议从精简AGENTS.md开始，逐步引入组件，记住核心原则：成功应用应减少默认上下文消耗。

项目资源：双语维护（英/韩），核心文档包括agentOperatingKit.md、应用指南、组件选择指南等。