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,8 +25,6 @@
25 25
26 ### 2.4 错误处理 26 ### 2.4 错误处理
27 27
28 -### 2.5 样式与主题  
29 -  
30 ## 三、共同约定 28 ## 三、共同约定
31 29
32 ### 3.1 Git 提交 30 ### 3.1 Git 提交
@@ -37,5 +35,3 @@ @@ -37,5 +35,3 @@
37 ### 3.3 日期与金额 35 ### 3.3 日期与金额
38 36
39 ### 3.4 数据访问规约 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 * 命名格式:--color-<scope>-<role>-<state> 4 * 命名格式:--color-<scope>-<role>-<state>
7 * <scope> 组件域:form / table-row / table-header / ... 5 * <scope> 组件域:form / table-row / table-header / ...
@@ -11,7 +9,7 @@ @@ -11,7 +9,7 @@
11 * 约束: 9 * 约束:
12 * - 组件样式中只用 var(--color-xxx),禁止硬编码 hex / rgba 10 * - 组件样式中只用 var(--color-xxx),禁止硬编码 hex / rgba
13 * - 修改色值只改本文件,不允许在组件级覆盖 11 * - 修改色值只改本文件,不允许在组件级覆盖
14 - * - 新增 token 须先登记到 docs/06 § 2.1 / 2.2,再补到此处 12 + * - 新增 token 直接在本文件登记(本文件即单一来源)
15 */ 13 */
16 14
17 :root { 15 :root {
@@ -25,7 +23,7 @@ @@ -25,7 +23,7 @@
25 --color-border: #d9d9d9; 23 --color-border: #d9d9d9;
26 --color-bg-base: #f0f2f5; 24 --color-bg-base: #f0f2f5;
27 25
28 - /* === 2. 组件级状态色(与 docs/06 § 2.2 一一对应) === */ 26 + /* === 2. 组件级状态色 === */
29 27
30 /* form:输入框 / 备注框 / 时间框 / 下拉框共用 */ 28 /* form:输入框 / 备注框 / 时间框 / 下拉框共用 */
31 --color-form-bg-edit: #ffffff; 29 --color-form-bg-edit: #ffffff;
workflows/coding.mjs
@@ -133,7 +133,7 @@ function featureStageContract(phase) { @@ -133,7 +133,7 @@ function featureStageContract(phase) {
133 return [ 133 return [
134 '## 硬约束(非交互子代理)', 134 '## 硬约束(非交互子代理)',
135 '- 你是 Workflow 派生的**非交互子代理**,物理上无法弹出 AskUserQuestion / 等待人类输入。**绝不要尝试问人**。', 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 '- 仍查不到 → **不要编造、不要留 `【人工填写:】` / `TBD` / `TODO` 占位**;把具体阻塞点(缺哪个值、应在哪个 Plan 闸门锁定、为何无法继续)写进产物。', 137 '- 仍查不到 → **不要编造、不要留 `【人工填写:】` / `TBD` / `TODO` 占位**;把具体阻塞点(缺哪个值、应在哪个 Plan 闸门锁定、为何无法继续)写进产物。',
138 '- 然后让本步骤以非零结果 / 显式 throw 结束,由上层 Workflow 转为带诊断的 halt(fail-fast)。', 138 '- 然后让本步骤以非零结果 / 显式 throw 结束,由上层 Workflow 转为带诊断的 halt(fail-fast)。',
139 '- 全部输出文档**使用中文**。', 139 '- 全部输出文档**使用中文**。',
@@ -247,8 +247,8 @@ function planPrompt(id, phase, specPath) { @@ -247,8 +247,8 @@ function planPrompt(id, phase, specPath) {
247 '## 输入', 247 '## 输入',
248 `- 上游 spec:\`${specPath}\`(已由 spec stage 落盘;不存在则 halt)。**plan 文件名日期前缀必须与 spec 一致**:取 spec 文件名首段 \`YYYY-MM-DD\`,写到 plan 路径,不要重新解析"今天"。`, 248 `- 上游 spec:\`${specPath}\`(已由 spec stage 落盘;不存在则 halt)。**plan 文件名日期前缀必须与 spec 一致**:取 spec 文件名首段 \`YYYY-MM-DD\`,写到 plan 路径,不要重新解析"今天"。`,
249 fe 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 '- Plan 告诉 TDD 执行者**做什么**,不是**怎么写代码**(执行者是同模型、全上下文的 tdd stage)。', 254 '- Plan 告诉 TDD 执行者**做什么**,不是**怎么写代码**(执行者是同模型、全上下文的 tdd stage)。',