From 344b1150389691d2547a053cd230a88154b237db Mon Sep 17 00:00:00 2001
From: wkc <978997012@qq.com>
Date: Sun, 26 Apr 2026 16:18:41 +0800
Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20AGENTS=20=E5=8D=8F?=
 =?UTF-8?q?=E4=BD=9C=E8=A7=84=E5=88=99?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENTS.md                                     | 39 +++++++++++++++++++
 .../2026-04-26-agents-md-update.md            | 22 +++++++++++
 2 files changed, 61 insertions(+)
 create mode 100644 docs/reports/implementation/2026-04-26-agents-md-update.md

diff --git a/AGENTS.md b/AGENTS.md
index 7533b742..b626b73b 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,5 +1,44 @@
 # AGENTS.md - AI Coding Assistant Guide
 
+## 全局执行规则
+
+### Git
+
+- Git 提交时使用中文添加描述
+- 无视 `.DS_Store`
+
+### AGENT
+
+- `using-superpowers` 只有在用户明确声明调用时才允许启用；不要因为“会话开始”“任务较复杂”或“可能适用”而自动调用
+- 当用户没有明确声明 `using-superpowers` 时，按普通流程直接处理需求
+- 默认不开启 subagent
+- 如用户明确要求启用 subagent，所有 subagent 必须使用 `gpt-5.5`；默认推理强度为高，审查类 subagent 的推理强度为超高，测试类 subagent 的推理强度为中
+
+### 文档
+
+- 写完的设计文档必须要由审查类子代理进行内容审查，确保方案与实施方法符合实际需求，并检查是否还有需要明确的功能点
+- 当功能设计涉及到前端和后端都有改动时，输出两份执行文档，一份为后端的实施计划，一份为前端的实施计划。如果不是前后端架构的项目不需要输出两份执行文档
+- 当功能修改只涉及到前端或只涉及到后端，只需要输出对应的实施计划
+- 每一次改动都需要留下实施文档，记录修改的内容
+- 每次写设计文档的时候，都要检查一下保存路径是否正确
+
+### 测试
+
+- 测试结束后，自动结束测试时开启的前后端进程
+- 前端 Node 需要使用 nvm 进行控制版本
+- 在完成页面功能开发后，必须调用 Playwright 打开浏览器进行实际页面测试，禁止打开 prototype 原型页面进行测试
+- 所有生成的测试文件不需要上传到 Git
+
+### 方案规范
+
+当需要给出方案时必须符合以下规范：
+
+- 不允许给出兼容性或补丁性的方案，不允许过度设计，保持最短路径实现且不能违反第一条要求
+- 不允许自行给出用户提供的需求以外的方案，例如一些兜底和降级方案，这可能导致业务逻辑偏移问题
+- 必须确保方案的逻辑正确，必须经过全链路的逻辑验证
+
+---
+
 ## 项目概述
 
 本仓库是纪检初核系统主仓库，基于若依 `v3.9.1`，当前技术栈以 `Java 21 + Spring Boot 3 + Vue 2` 为主，并包含独立的流水分析 Mock 服务、Docker 部署文件、SQL 脚本、实施文档与测试文档。
diff --git a/docs/reports/implementation/2026-04-26-agents-md-update.md b/docs/reports/implementation/2026-04-26-agents-md-update.md
new file mode 100644
index 00000000..b75adb0c
--- /dev/null
+++ b/docs/reports/implementation/2026-04-26-agents-md-update.md
@@ -0,0 +1,22 @@
+# AGENTS.md 更新实施记录
+
+## 修改时间
+
+2026-04-26
+
+## 修改内容
+
+- 在根目录 `AGENTS.md` 中补充全局执行规则，覆盖 Git、AGENT、文档、测试与方案规范。
+- 明确 `using-superpowers` 与 subagent 的启用条件及模型要求。
+- 明确设计文档审查、前后端实施计划拆分、实施文档留存、Playwright 页面测试、测试文件不提交等要求。
+
+## 影响范围
+
+- 仅影响 AI 编码助手在本仓库内的协作规则与执行约束。
+- 未修改业务代码、数据库脚本、前端页面或后端接口。
+
+## 验证情况
+
+- 已确认 `AGENTS.md` 位于仓库根目录。
+- 已确认实施记录保存路径为 `docs/reports/implementation/`。
+- 本次为文档规则更新，不涉及编译、单元测试或页面测试。