docs: CODING_RULES 更名为 TOP_CODING_RULES 并补齐通用规则与踩坑清单

改名(对齐 pj0034 的 TOP_ 前缀):
- CODING_RULES.md → TOP_CODING_RULES.md,同步 5 处引用
  (CLAUDE.md 目录树与启动仪式、PROJECT_STATE.md 三处、DR03、DR04、文件内 G06 自引用)

补齐通用部分 G09–G18(承接 pj0034 同名文件的通用规则,按本项目
Go / Vue3 / SQLite / Ubuntu 技术栈改写):
- G09 登录态与接口必须无状态化
- G10 配置化优先,禁止写死环境细节
- G11 素材必须可追溯,不可静默修改
- G12 长耗时任务必须异步化
- G13 先跑通主线,再细化和优化
- G14 Git 不抢戏 — 收工时统一提示一次
- G15 禁止通用名启动入口文件,启动逻辑必须在 start_dev_10231_10232.sh
- G16 Windows 侧 .ps1 脚本统一 UTF-8 with BOM
- G17 脚本内禁止兼容式依赖回退,必须固定单一工具链
- G18 仓库应尽量支持拷贝后直接运行
不抄的(逐条判断本项目不适用):Python 虚拟环境、Playwright/clickflow E2E、
OSS 多租户、Amazon 平台规范检测;该判断已写进文件头说明。

G04 补第 6–10 条:全绿≠跑通、报告事实而非意图、读清用户的 bug 描述、
修 UI bug 追完整渲染链、跨区移动数据后验另一端完整性。

新增 P06 常见技术陷阱清单(11 条,全部来自本项目真实事故或核过代码的事实):
AutoMigrate 只加不删、探测脚本用完即删、worker_run.status 恒为 done、
seed 只补空字段、禁止按进程名模糊匹配杀进程、Element Plus persistent
留隐藏 DOM、动用户数据前先备份再列清单、hash 路由改 hash 不重载、
gofmt 不要整个目录 -w、git remote 禁嵌明文凭据、禁引第三方受限素材。

顺手修三处不一致:P01 索引名过时(培训平台→通用数字员工平台)、
DR03 引用的编号在重组后指向了错规则(第 6 条→G07)、第二部分标题层级。

版号 V1.0 → V1.1。

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
eaiadmin
2026-09-17 22:59:17 +08:00
co-authored by Claude Code
parent 16d63de4e1
commit 6194c4733e
6 changed files with 530 additions and 249 deletions
+2 -2
View File
@@ -19,7 +19,7 @@
```
pj0235-eai_agentplatform-ubu/ # 工作区根(仓库根)
├── CODING_RULES.md # 编码与调试最高准则
├── TOP_CODING_RULES.md # 编码与调试最高准则
├── start_dev_10231_10232.sh # 开发启动脚本
├── docs/ # 设计文档(项目级,与代码分离)
│ ├── 00_AI_Context/ # AI 协作上下文
@@ -53,7 +53,7 @@ pj0235-eai_agentplatform-ubu/ # 工作区根(仓库根)
1. 确认你的角色:后端(backend)/ 前端(frontend)/ 全栈
2. 读 `PROJECT_STATE.md`(本目录)—— 项目当前全局状态与已拍板决策
3. 读 `../CODING_RULES.md`(工作区根)—— 编码与调试最高准则
3. 读 `../TOP_CODING_RULES.md`(工作区根)—— 编码与调试最高准则
完成以上步骤,才开始响应用户。
+3 -3
View File
@@ -14,7 +14,7 @@
### 已完成
- ✅ PRD V1.1 最终定稿(docs/PRD.md / 设计稿)
- ✅ 文档架构搭建(docs/ 体系)
- ✅ 编码规范制定(CODING_RULES.md / CLAUDE.md / PROJECT_STATE.md)
- ✅ 编码规范制定(TOP_CODING_RULES.md / CLAUDE.md / PROJECT_STATE.md)
- ✅ 知识入库体系(BE05)后端代码落地:knowledge_source 表 + 解析/扫描/摄入 + 审批 API + 脚本
### 已完成(Go 后端)
@@ -81,14 +81,14 @@
| 变更日志 | `../docs/changelog.md` | 版本变更记录 |
| 知识入库体系 | `../docs/04_Backend/BE05_Knowledge_Ingest_Module.md` | 上传→生成→审批→入库总设计 |
| 知识源目录 | `backend-go/knowledge_source/` | 结构化知识源 md(5 份,28 产品 + 20 题) |
| 编码准则 | `../CODING_RULES.md` | 编码与调试最高准则 |
| 编码准则 | `../TOP_CODING_RULES.md` | 编码与调试最高准则 |
| AI 协作锚点 | `CLAUDE.md` | AI 新对话启动仪式 |
## 5. 目录结构(当前)
```
pj0235-eai_agentplatform-ubu/ # 工作区根(仓库根)
├── CODING_RULES.md # 编码与调试最高准则
├── TOP_CODING_RULES.md # 编码与调试最高准则
├── start_dev_10231_10232.sh # 开发启动脚本
├── docs/ # 设计文档(项目级,与代码分离)
│ ├── 00_AI_Context/ # AI 协作上下文