 eaiadminandClaude Code
|
6194c4733e
|
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>
|
2026-09-17 22:59:17 +08:00 |
|