Commit 54356b2b7a588063399fcba902aa69f286989362

Authored by zichun
1 parent a1f2447b

docs-04: drop § 2.5/3.5; tokens.css = sole token source; align coding.mjs § refs

- docs-04 template: remove § 2.5 样式与主题 (tokens live in src/styles/tokens.css) + § 3.5 配置与安全 (config in config-vars.yaml, rules in docs/07→now config-vars header)
- styles-tokens-template.css: fix 3 stale docs/06 refs missed in the earlier docs/06 removal (greps had excluded *.css) → self-contained '色值单一来源 / SSoT'
- coding.mjs: frontend ref §一 前端架构 → §二 前端规范 (§一 is 后端); backend drop frontend §2.1 → §1.2 分层; 样式/色值 → tokens.css; remove docs/07 from value-lookup order
skills/plan/skeleton-gen/templates/docs-04-skeleton-template.md
... ... @@ -25,8 +25,6 @@
25 25  
26 26 ### 2.4 错误处理
27 27  
28   -### 2.5 样式与主题
29   -
30 28 ## 三、共同约定
31 29  
32 30 ### 3.1 Git 提交
... ... @@ -37,5 +35,3 @@
37 35 ### 3.3 日期与金额
38 36  
39 37 ### 3.4 数据访问规约
40   -
41   -### 3.5 配置与安全
... ...
skills/plan/skeleton-gen/templates/styles-tokens-template.css
1 1 /*
2   - * src/styles/tokens.css — Design Tokens
3   - * 命名规范见 docs/04-技术规范.md § 2.5
4   - * 色值锁定见 docs/06-UI交互规范.md § 二
  2 + * src/styles/tokens.css — Design Tokens(色值的单一来源 / SSoT)
5 3 *
6 4 * 命名格式:--color-<scope>-<role>-<state>
7 5 * <scope> 组件域:form / table-row / table-header / ...
... ... @@ -11,7 +9,7 @@
11 9 * 约束:
12 10 * - 组件样式中只用 var(--color-xxx),禁止硬编码 hex / rgba
13 11 * - 修改色值只改本文件,不允许在组件级覆盖
14   - * - 新增 token 须先登记到 docs/06 § 2.1 / 2.2,再补到此处
  12 + * - 新增 token 直接在本文件登记(本文件即单一来源)
15 13 */
16 14  
17 15 :root {
... ... @@ -25,7 +23,7 @@
25 23 --color-border: #d9d9d9;
26 24 --color-bg-base: #f0f2f5;
27 25  
28   - /* === 2. 组件级状态色(与 docs/06 § 2.2 一一对应) === */
  26 + /* === 2. 组件级状态色 === */
29 27  
30 28 /* form:输入框 / 备注框 / 时间框 / 下拉框共用 */
31 29 --color-form-bg-edit: #ffffff;
... ...
workflows/coding.mjs
... ... @@ -133,7 +133,7 @@ function featureStageContract(phase) {
133 133 return [
134 134 '## 硬约束(非交互子代理)',
135 135 '- 你是 Workflow 派生的**非交互子代理**,物理上无法弹出 AskUserQuestion / 等待人类输入。**绝不要尝试问人**。',
136   - '- 缺值查找顺序:`config-vars.yaml` → `docs/07-环境配置.md` → `docs/04-技术规范.md` → `docs/05-API接口契约.md` → `prototype/`(前端布局/交互权威)→ `src/styles/tokens.css`(前端色值)→ `CLAUDE.md` → 现有代码。',
  136 + '- 缺值查找顺序:`config-vars.yaml` → `docs/04-技术规范.md` → `docs/05-API接口契约.md` → `prototype/`(前端布局/交互权威)→ `src/styles/tokens.css`(前端色值)→ `CLAUDE.md` → 现有代码。',
137 137 '- 仍查不到 → **不要编造、不要留 `【人工填写:】` / `TBD` / `TODO` 占位**;把具体阻塞点(缺哪个值、应在哪个 Plan 闸门锁定、为何无法继续)写进产物。',
138 138 '- 然后让本步骤以非零结果 / 显式 throw 结束,由上层 Workflow 转为带诊断的 halt(fail-fast)。',
139 139 '- 全部输出文档**使用中文**。',
... ... @@ -247,8 +247,8 @@ function planPrompt(id, phase, specPath) {
247 247 '## 输入',
248 248 `- 上游 spec:\`${specPath}\`(已由 spec stage 落盘;不存在则 halt)。**plan 文件名日期前缀必须与 spec 一致**:取 spec 文件名首段 \`YYYY-MM-DD\`,写到 plan 路径,不要重新解析"今天"。`,
249 249 fe
250   - ? `- \`${ROOT}/docs/04-技术规范.md § 一 前端架构\`(路由 / 状态库 / 组件目录约定 / 测试栈)+ \`§ 2.1 目录约定\`(落盘位置)。用 Grep 在 \`${ROOT}/frontend/\` 定位现有文件。`
251   - : `- \`${ROOT}/docs/04-技术规范.md\`(编码规范 + § 1.2 分层 / § 2.1 目录规范)。用 Grep 在现有代码定位待修改文件。`,
  250 + ? `- \`${ROOT}/docs/04-技术规范.md § 二 前端规范\`(§ 2.1 目录约定 = 落盘位置;状态管理 / 请求封装 / 错误处理);色值 / 样式见 \`${ROOT}/src/styles/tokens.css\`;测试栈见 § 零。用 Grep 在 \`${ROOT}/frontend/\` 定位现有文件。`
  251 + : `- \`${ROOT}/docs/04-技术规范.md\`(编码规范 + § 1.2 分层结构 = 后端落盘)。用 Grep 在现有代码定位待修改文件。`,
252 252 '',
253 253 '## 计划写作原则',
254 254 '- Plan 告诉 TDD 执行者**做什么**,不是**怎么写代码**(执行者是同模型、全上下文的 tdd stage)。',
... ...