From 54356b2b7a588063399fcba902aa69f286989362 Mon Sep 17 00:00:00 2001 From: zichun Date: Fri, 29 May 2026 14:43:27 +0800 Subject: [PATCH] docs-04: drop § 2.5/3.5; tokens.css = sole token source; align coding.mjs § refs --- skills/plan/skeleton-gen/templates/docs-04-skeleton-template.md | 4 ---- skills/plan/skeleton-gen/templates/styles-tokens-template.css | 8 +++----- workflows/coding.mjs | 6 +++--- 3 files changed, 6 insertions(+), 12 deletions(-) diff --git a/skills/plan/skeleton-gen/templates/docs-04-skeleton-template.md b/skills/plan/skeleton-gen/templates/docs-04-skeleton-template.md index 37484e1..5e4f4da 100644 --- a/skills/plan/skeleton-gen/templates/docs-04-skeleton-template.md +++ b/skills/plan/skeleton-gen/templates/docs-04-skeleton-template.md @@ -25,8 +25,6 @@ ### 2.4 错误处理 -### 2.5 样式与主题 - ## 三、共同约定 ### 3.1 Git 提交 @@ -37,5 +35,3 @@ ### 3.3 日期与金额 ### 3.4 数据访问规约 - -### 3.5 配置与安全 diff --git a/skills/plan/skeleton-gen/templates/styles-tokens-template.css b/skills/plan/skeleton-gen/templates/styles-tokens-template.css index 89905b7..b81cd24 100644 --- a/skills/plan/skeleton-gen/templates/styles-tokens-template.css +++ b/skills/plan/skeleton-gen/templates/styles-tokens-template.css @@ -1,7 +1,5 @@ /* - * src/styles/tokens.css — Design Tokens - * 命名规范见 docs/04-技术规范.md § 2.5 - * 色值锁定见 docs/06-UI交互规范.md § 二 + * src/styles/tokens.css — Design Tokens（色值的单一来源 / SSoT） * * 命名格式：--color--- * 组件域：form / table-row / table-header / ... @@ -11,7 +9,7 @@ * 约束： * - 组件样式中只用 var(--color-xxx)，禁止硬编码 hex / rgba * - 修改色值只改本文件，不允许在组件级覆盖 - * - 新增 token 须先登记到 docs/06 § 2.1 / 2.2，再补到此处 + * - 新增 token 直接在本文件登记（本文件即单一来源） */ :root { @@ -25,7 +23,7 @@ --color-border: #d9d9d9; --color-bg-base: #f0f2f5; - /* === 2. 组件级状态色（与 docs/06 § 2.2 一一对应） === */ + /* === 2. 组件级状态色 === */ /* form：输入框 / 备注框 / 时间框 / 下拉框共用 */ --color-form-bg-edit: #ffffff; diff --git a/workflows/coding.mjs b/workflows/coding.mjs index 86f1502..726d7b5 100644 --- a/workflows/coding.mjs +++ b/workflows/coding.mjs @@ -133,7 +133,7 @@ function featureStageContract(phase) { return [ '## 硬约束（非交互子代理）', '- 你是 Workflow 派生的**非交互子代理**，物理上无法弹出 AskUserQuestion / 等待人类输入。**绝不要尝试问人**。', - '- 缺值查找顺序：`config-vars.yaml` → `docs/07-环境配置.md` → `docs/04-技术规范.md` → `docs/05-API接口契约.md` → `prototype/`（前端布局/交互权威）→ `src/styles/tokens.css`（前端色值）→ `CLAUDE.md` → 现有代码。', + '- 缺值查找顺序：`config-vars.yaml` → `docs/04-技术规范.md` → `docs/05-API接口契约.md` → `prototype/`（前端布局/交互权威）→ `src/styles/tokens.css`（前端色值）→ `CLAUDE.md` → 现有代码。', '- 仍查不到 → **不要编造、不要留 `【人工填写：】` / `TBD` / `TODO` 占位**；把具体阻塞点（缺哪个值、应在哪个 Plan 闸门锁定、为何无法继续）写进产物。', '- 然后让本步骤以非零结果 / 显式 throw 结束，由上层 Workflow 转为带诊断的 halt（fail-fast）。', '- 全部输出文档**使用中文**。', @@ -247,8 +247,8 @@ function planPrompt(id, phase, specPath) { '## 输入', `- 上游 spec：\`${specPath}\`（已由 spec stage 落盘；不存在则 halt）。**plan 文件名日期前缀必须与 spec 一致**：取 spec 文件名首段 \`YYYY-MM-DD\`，写到 plan 路径，不要重新解析"今天"。`, fe - ? `- \`${ROOT}/docs/04-技术规范.md § 一 前端架构\`（路由 / 状态库 / 组件目录约定 / 测试栈）+ \`§ 2.1 目录约定\`（落盘位置）。用 Grep 在 \`${ROOT}/frontend/\` 定位现有文件。` - : `- \`${ROOT}/docs/04-技术规范.md\`（编码规范 + § 1.2 分层 / § 2.1 目录规范）。用 Grep 在现有代码定位待修改文件。`, + ? `- \`${ROOT}/docs/04-技术规范.md § 二 前端规范\`（§ 2.1 目录约定 = 落盘位置；状态管理 / 请求封装 / 错误处理）；色值 / 样式见 \`${ROOT}/src/styles/tokens.css\`；测试栈见 § 零。用 Grep 在 \`${ROOT}/frontend/\` 定位现有文件。` + : `- \`${ROOT}/docs/04-技术规范.md\`（编码规范 + § 1.2 分层结构 = 后端落盘）。用 Grep 在现有代码定位待修改文件。`, '', '## 计划写作原则', '- Plan 告诉 TDD 执行者**做什么**，不是**怎么写代码**（执行者是同模型、全上下文的 tdd stage）。', -- libgit2 0.22.2