Nexus/docs/changelog/2026-05-22-implementation-standards-rule.md

Changelog — 完美实现与文档纪律全局规则

日期: 2026-05-22
类型: 流程 / 规范
动机: 将「完美实现、禁止降级/妥协/技术债、文档先行、每次修改留 changelog」固化为项目全局约束，供 Cursor 与所有 Agent 会话强制执行。

变更摘要

1. 新增 Cursor 全局规则 .cursor/rules/perfect-implementation.mdc（alwaysApply: true）
2. 在 CLAUDE.md、AGENTS.md 增加「实现原则」章节，与规则文件交叉引用
3. 明确文档路径与执行顺序：设计文档 → 技术文档 → 实现 → 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: true
• CLAUDE.md / AGENTS.md 已同步
• 主仓库 Nexus/CLAUDE.md 若与 worktree 分叉，合并时需同步本节

部署/迁移

无需重启服务；规则在下次 Cursor 会话中自动生效。