# 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`

## 验证

- [x] `.cursor/rules/perfect-implementation.mdc` 存在且 `alwaysApply: true`
- [x] `CLAUDE.md` / `AGENTS.md` 已同步
- [ ] 主仓库 `Nexus/CLAUDE.md` 若与 worktree 分叉，合并时需同步本节

## 部署/迁移

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