From 90f483f427974e23df993ce3074e877fa17d2d38 Mon Sep 17 00:00:00 2001 From: wkc <978997012@qq.com> Date: Mon, 20 Jul 2026 15:43:25 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0agents?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 84 +++++-------------------------------------------------- 1 file changed, 7 insertions(+), 77 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index dcc82d1f..39f02378 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,44 +1,5 @@ # 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 进行控制版本 -- 在完成页面功能开发后,必须使用 `browser-use` 技能打开浏览器进行实际页面测试,禁止打开 prototype 原型页面进行测试 -- 所有生成的测试文件不需要上传到 Git - -### 方案规范 - -当需要给出方案时必须符合以下规范: - -- 不允许给出兼容性或补丁性的方案,不允许过度设计,保持最短路径实现且不能违反第一条要求 -- 不允许自行给出用户提供的需求以外的方案,例如一些兜底和降级方案,这可能导致业务逻辑偏移问题 -- 必须确保方案的逻辑正确,必须经过全链路的逻辑验证 - ---- - ## 项目概述 本仓库是纪检初核系统主仓库,基于若依 `v3.9.1`,当前技术栈以 `Java 21 + Spring Boot 3 + Vue 2` 为主,并包含独立的流水分析 Mock 服务、Docker 部署文件、SQL 脚本、实施文档与测试文档。 @@ -54,52 +15,26 @@ --- -## 高优先级规则 - -- 使用简体中文进行思考和对话 -- Git 提交说明必须使用中文 -- 忽略 `.DS_Store` 文件,不将其视为本次任务需要处理或提交的有效变更 -- 仅当用户明确声明调用 `using-superpowers` 时才允许启用;未明确声明时按普通流程直接处理需求 -- Git 提交前必须检查暂存区,仅允许包含本次任务相关文件;若存在无关文件,必须先移出暂存或与用户确认 -- 每一次改动都需要留下实施文档,记录修改内容、影响范围与验证情况 -- 功能设计同时涉及前端和后端改动时,必须分别输出后端与前端两份实施计划;若仅涉及单侧,则只输出对应实施计划 -- 新增或修改设计文档、实施计划、实施记录前,必须先确认保存路径是否正确 -- 前端相关安装、构建、调试、测试命令执行前,必须先通过 `nvm` 切换并确认 Node 版本 -- 测试结束后,自动关闭测试过程中启动的前后端进程 -- 重启后端时,必须优先使用 `bin/restart_java_backend.sh` -- 禁止在前端源码、配置、示例数据或页面默认值中硬编码或预填真实账号密码;登录页不得将密码保存到 Cookie、localStorage 或 sessionStorage - ---- - ## 协作约定 ### 基础协作 +- 使用简体中文进行思考和对话 - 前端开发直接在当前分支进行,不需要额外创建 git worktree -- 给出方案时,必须保持最短路径实现,不允许提供兼容性、补丁性或过度设计的方案 -- 不允许自行扩展出用户需求之外的兜底、降级或变体方案,避免业务逻辑偏移 -- 输出方案前必须完成全链路逻辑校验,确保方案逻辑正确、链路闭环 ### Git 与变更管理 -- Git 提交前必须检查暂存区,仅保留本次任务相关文件 -- 若暂存区存在无关文件,必须先移出暂存或与用户确认,禁止顺带提交 -- `.DS_Store` 默认忽略,不纳入任务变更范围 +- Git 提交前必须检查暂存区,仅保留本次任务相关文件;若存在无关文件,必须先移出暂存或与用户确认,禁止顺带提交 ### 文档产出 -- 若需求来自设计文档,默认同时沉淀后端与前端两份实施计划 -- 功能设计同时涉及前端和后端改动时,实施计划分别放在 `docs/plans/backend/` 与 `docs/plans/frontend/` -- 功能修改只涉及前端或只涉及后端时,只输出对应的实施计划 -- 非前后端架构项目不强制拆分两份实施计划 -- 每一次改动都需要留下实施文档,实施记录优先放在 `docs/reports/implementation/` -- 每次新增或修改设计文档、实施计划、实施记录前,都要先确认保存路径是否正确 +- 后端实施计划放在 `docs/plans/backend/`,前端实施计划放在 `docs/plans/frontend/` +- 综合实施计划、联调计划和通用实施文档放在 `docs/plans/fullstack/` +- 每一次改动都需要留下实施文档,记录修改内容、影响范围与验证情况;实施记录优先放在 `docs/reports/implementation/` ### 测试与运行 -- 测试结束后,自动关闭测试过程中启动的前后端进程 - 重启后端时,必须优先使用 `bin/restart_java_backend.sh`,不要直接手工执行 `java -jar` 替代正式重启流程 -- 前端相关安装、构建、调试、测试命令执行前,必须先通过 `nvm` 切换并确认 Node 版本 ### 数据库与编码 @@ -258,7 +193,8 @@ return AjaxResult.success(result); - 请求统一使用 `@/utils/request` - 新增页面或功能入口时,同步检查 `sys_menu`、路由、权限标识 - 优先延续现有 `ccdi*` 业务目录与命名方式,不随意新造平行目录 -- 登录页只能在用户主动选择时保存用户名,不允许保存密码或预填默认密码 +- 禁止在前端源码、配置、示例数据或页面默认值中硬编码或预填真实账号密码 +- 登录页只能在用户主动选择时保存用户名,不允许将密码保存到 Cookie、localStorage 或 sessionStorage,也不允许预填默认密码 ### 导入功能规范 @@ -386,10 +322,6 @@ ccdi/ - 新增文档优先落到 `docs/` 下的规范目录,不要继续堆放到 `docs/plans/` 根目录 - 只有历史资料或外部原始材料才放入 `assets/` - 如果移动了文档,需同步修正文档内引用路径 -- 若需求来自设计文档,默认同时沉淀后端与前端两份实施计划 -- 功能设计同时涉及前端和后端改动时,必须分别输出后端与前端两份实施计划;若仅涉及前端或仅涉及后端,则只输出对应实施计划;非前后端架构项目不强制拆分双文档 -- 每一次改动都需要留下实施文档,记录本次修改内容、影响范围与验证情况,实施记录优先放在 `docs/reports/implementation/` -- 每次新增或修改设计文档、实施计划、实施记录前,都要先确认保存路径是否正确 --- @@ -399,5 +331,3 @@ ccdi/ - `lsfx-mock-server` 是独立子项目,除非任务涉及流水分析联调,否则不要把其实现规则混入主 Java 工程 - `docker/backend`、`docker/frontend`、`docker/mock` 分别对应三类运行时镜像 - `sql/migration/` 用于增量迁移脚本,新增修复脚本优先按日期或功能命名 -- 启动前后端或 Mock 服务做验证后,结束测试时要主动停止进程,避免残留占用端口 -- 前端相关安装、构建、调试、测试命令执行前,必须先通过 `nvm` 切换并确认 Node 版本