aa65f10c52
Audit docs:
- docs/reports/audit-phase-2{a-j}-line-walk.md: per-file line walk findings
- docs/reports/audit-phase-2-findings-matrix.md: 63 findings (52 fixed, 3 partial, 7 accepted)
- docs/reports/2026-05-23-full-audit-report.md: full audit consolidation
- docs/reports/audit-full-vs-phase2-reconciliation.md: cross-reference
- docs/reports/audit-phase-2-walk-closure.md: closure sign-off
Project docs:
- docs/project/phase-2-audit-remediation.md: SSOT for all fixes
- docs/project/alert-push-policy.md: dashboard alert design decisions
- docs/project/production-verification-checklist.md: first-deploy checklist
- docs/project/script-execution.md: script platform design
- docs/project/wsl-integration-test.md: WSL code-only verification guide
- docs/project/line-walk-audit-standard.md: audit methodology
- docs/project/mysql-mcp-setup.md: MCP config guide
Changelogs: 18 entries (2026-05-22 to 2026-05-23)
Project memory: CLAUDE.md, AGENTS.md updated to reflect current state
Deploy: nginx_https.conf template updated
Co-authored-by: Cursor <cursoragent@cursor.com>
1.5 KiB
1.5 KiB
Changelog — 完美实现与文档纪律全局规则
日期: 2026-05-22
类型: 流程 / 规范
动机: 将「完美实现、禁止降级/妥协/技术债、文档先行、每次修改留 changelog」固化为项目全局约束,供 Cursor 与所有 Agent 会话强制执行。
变更摘要
- 新增 Cursor 全局规则
.cursor/rules/perfect-implementation.mdc(alwaysApply: true) - 在
CLAUDE.md、AGENTS.md增加「实现原则」章节,与规则文件交叉引用 - 明确文档路径与执行顺序:设计文档 → 技术文档 → 实现 → changelog
涉及文件
| 文件 | 操作 |
|---|---|
.cursor/rules/perfect-implementation.mdc |
新增 |
CLAUDE.md |
增补实现原则与文档纪律 |
AGENTS.md |
增补实现原则表格 |
docs/changelog/2026-05-22-implementation-standards-rule.md |
新增(本文件) |
规则要点
- 禁止:为实现而实现、降级实现、妥协实现、留技术债
- 无法完美实现:必须停下与用户沟通后才能换方案
- 设计前:
docs/design/specs/YYYY-MM-DD-*-design.md - 开发前:
docs/design/plans/或docs/reports/技术文档;缺文档模块改动时补全 - 每次修改:
docs/changelog/YYYY-MM-DD-*.md
验证
.cursor/rules/perfect-implementation.mdc存在且alwaysApply: trueCLAUDE.md/AGENTS.md已同步- 主仓库
Nexus/CLAUDE.md若与 worktree 分叉,合并时需同步本节
部署/迁移
无需重启服务;规则在下次 Cursor 会话中自动生效。