agents模板：为AI编程助手打造的标准化行为指南框架

wcgomes/agents项目提供极简、环境无关的AGENTS.md模板，定义AI编程助手的核心行为准则、Wiki记忆系统、工作流规范、专家代理委派及上下文管理策略，解决不同项目/团队中AI助手行为不一致问题，通过强制性规范确保可预测性，助力AI像人类团队成员般遵循规范、积累知识、保障质量。

随着AI编程助手在软件开发中的普及，如何确保其在不同项目、团队中表现一致、可预测成为关键问题。wcgomes/agents项目应运而生，提供具有约束力的行为规范模板，明确要求“在每个任务、会话中遵循”，以解决这一痛点。

核心行为准则

1. 明确假设与主动沟通：实施前陈述假设，遇模糊处询问，呈现所有可能性，主动提出更优方案。
2. 信息密度原则：输出需极简（删除冠词、填充词、客套话等），推荐句式【事物】【动作】【原因】【下一步】，例外情况（代码块、安全警告等）需完整书写。

目标导向与代码质量

• 任务需明确可验证目标，多步骤任务先分享计划获确认；执行后测试、检查规范，展示diff待批准再应用；连续两周期无进展则止损求助。
• 代码遵循极简主义：写最少代码、不添加推测功能、遵循现有风格、删除未使用代码（不触碰预先死代码）。

Wiki记忆系统

• 结构规范：wiki/目录为唯一持久记忆，含index.md（必更新）、architecture.md等页面，新页面需从index.md链接。
• 操作流程：摄取（任务结束主动更新wiki）、查询（先读wiki/index.md）、整理（修复矛盾/孤立页面）。

专家代理委派

• 默认委派原则：先检查可用代理，有相关专家则委派（即使自己能完成），无则直接处理。
• 委派策略：单一领域派对应专家，多领域组建团队协调，多阶段可交专家协调器审查结果。

上下文管理

• 仅加载与当前任务相关的wiki页面，搜索源码前先查wiki；完成步骤后释放无关上下文，确保效率。

规则与理由对照表

规则	理由
创建文件前搜索现有功能扩展	防止蔓延重复
仅当扩展不可能时新建文件并说明原因	强制重用分析
生产代码不使用模拟数据（测试除外）	数据完整性
修复根本原因而非症状	代码质量
引用代码标注file:line	可追溯性

agents模板代表成熟的AI编程协作模式，通过明确约束让AI行为可预测、可审查、可维护。对团队的价值包括：

1. 一致性：不同会话行为一致，减少“每次都不一样”的困扰；
2. 可追溯性：Wiki记忆积累项目知识，不随会话结束丢失；
3. 质量保障：严格代码原则与测试要求，符合工程标准；
4. 效率提升：极简沟通与目标导向减少不必要来回。 其理念核心：AI编程助手应像人类团队成员，遵循规范、积累知识、对产出质量负责。