From 5fbf3746bea1b0d5c5214bd9c5ac487c4ed0bbe3 Mon Sep 17 00:00:00 2001
From: caoqianming <caoqianming@foxmail.com>
Date: Thu, 14 May 2026 10:43:02 +0800
Subject: [PATCH] =?UTF-8?q?docs(CLAUDE.md):=20=E5=8A=A0=E6=96=87=E6=A1=A3?=
 =?UTF-8?q?=E7=BB=B4=E6=8A=A4=E8=A7=84=E5=88=99=20=E2=80=94=20=E6=AF=8F?=
 =?UTF-8?q?=E6=AD=A5=E6=9B=B4=20PROGRESS,=E5=BF=85=E8=A6=81=E6=97=B6?=
 =?UTF-8?q?=E6=94=B9=20DESIGN?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

明确 PROGRESS / DESIGN 分工:工程笔记进 PROGRESS,架构 /
心智模型 / 取舍决策才动 DESIGN。避免把实施细节沉淀成"设计"。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 CLAUDE.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index ca41046..d4da472 100644
--- a/CLAUDE.md
+++ b/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。