docs(CLAUDE.md): 加文档维护规则 — 每步更 PROGRESS,必要时改 DESIGN
明确 PROGRESS / DESIGN 分工:工程笔记进 PROGRESS,架构 / 心智模型 / 取舍决策才动 DESIGN。避免把实施细节沉淀成"设计"。 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
parent
425ea59937
commit
5fbf3746be
15
CLAUDE.md
15
CLAUDE.md
|
|
@ -5,3 +5,18 @@
|
|||
- **Python 虚拟环境**: `.venv/`(项目根目录下),所有依赖装在里面
|
||||
- 跑脚本 / 测试一律用 `.venv/Scripts/python.exe ...`,**不要用全局 `python`**(没装 litellm/python-pptx 等会报 ModuleNotFoundError)
|
||||
- requirements 见 `requirements.txt`
|
||||
|
||||
## 文档维护
|
||||
|
||||
每完成一步实现(commit 前),**必须更新 `PROGRESS.md`**:
|
||||
- "已完成关键能力" 段加一条 `YYYY-MM-DD / <短标题>:<改了什么>`
|
||||
- 状态表(§7 B Step 几 / Phase 几)若变化跟着改
|
||||
- 文件清单若新增 / 删除模块跟着改
|
||||
|
||||
**只有以下情况才动 `DESIGN.md`**(避免把工程笔记沉淀成设计):
|
||||
- 架构 / 心智模型变化(如 §7.1 task-primary 重写)
|
||||
- 取舍决策推翻或新增(§5 / §7.9 类内容)
|
||||
- API / schema 字段语义变化(§7.2 / §7.4)
|
||||
- 实施中发现 DESIGN 描述与代码偏离 → 同步改回
|
||||
|
||||
bug 修复、重构、新加 skill、调参 —— **不动 DESIGN**,只更 PROGRESS。
|
||||
|
|
|
|||
Loading…
Reference in New Issue