From c2d4c16b27ad2295edf74851737c561b8cae2954 Mon Sep 17 00:00:00 2001 From: zichun Date: Fri, 29 May 2026 13:13:39 +0800 Subject: [PATCH] skeleton-gen: drop sql/migrations/.gitkeep; set tokens.css > prototype precedence for colors --- README.md | 2 +- agents/code-reviewer.md | 1 + skills/plan/skeleton-gen/SKILL.md | 7 ++++--- workflows/coding.mjs | 2 +- 4 files changed, 7 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 797beaf..aadd91d 100644 --- a/README.md +++ b/README.md @@ -121,7 +121,7 @@ erp-workflow-plugin/ |---|---|---|---| | A0 | `project-init` | • **依赖检查**：检测 git / mysql / node 是否在 PATH，缺失则按 OS 自动安装，装不上再停下提示用户
• 空目录初始化：用 Read/Write/Glob 工具拷模板创建 CLAUDE.md / docs/01/index.md / docs/08
• `git init` | `plan-start` | | A1 | `scope-lock` | • 引导填项目概述 / 技术栈 / 需求索引
• 按 `docs/01-需求清单//{_module.md, REQ-*.md}` 子目录结构生成 REQ 卡片（CC 据 index.md 填 `{{req_id/title/goal/rules/constraints/acceptance}}` 6 个占位，模板其余内容含输入/输出示例字段表原样复制）
• **A1 终结校验**：REQ 6 个占位均填真实数据、无 `{{` 残留、`config-vars.yaml` **全部配置**（包名 / 端口 / 初始账号 + DB 凭据 / 密钥占位）已锁、各 stack 的 build/lint/unit/e2e 命令写入 docs/04 § 零；缺失则在此（Plan 期）用 `AskUserQuestion` 问清（敏感凭据由用户自填，不进会话）
• 据模板直接 `Write` 生成 `_module.md` / `REQ-*.md`
• 终结校验通过后**自动**调用 `Skill(skeleton-gen)` 进入 A2（不停下） | A0 | -| A2 | `skeleton-gen` | • 生成架构文档：docs/04 § 一+ / docs/07 / docs/09
• 生成跨平台工具脚本：`scripts/*.mjs`（**无 chmod**；凭据 / 配置统一在 A1 产出的 config-vars.yaml）
• 创建 `sql/migrations/` 空目录（Flyway 准备）
• 用 `node ${CLAUDE_PLUGIN_ROOT}/lib/merge-gitignore.mjs` 合并 .gitignore（逐行判重） | `plan-start` | +| A2 | `skeleton-gen` | • 生成架构文档：docs/04 § 一+ / docs/07 / docs/09
• 生成跨平台工具脚本：`scripts/*.mjs`（**无 chmod**；凭据 / 配置统一在 A1 产出的 config-vars.yaml）
• 用 `node ${CLAUDE_PLUGIN_ROOT}/lib/merge-gitignore.mjs` 合并 .gitignore（逐行判重） | `plan-start` | | A3 | `db-design-gen` | • A3 起始用 `AskUserQuestion` 确认 ERP 约定（主键策略 / 租户列 / 列前缀规则，默认值可覆盖），结果写 docs/04 + CLAUDE.md
• 从 docs/01 REQ 卡片正向设计 `docs/03-数据库设计文档.md`（schema SSoT）
• 回填 REQ 卡片依赖表（`TBD(A3 自动补)` → 实际表名）
• **停下**等人工审阅 docs/03，审阅完毕用 `/plan-start` 续进 A4 | A2 | | A4 | `db-init` | • LLM 解析 docs/03 → `sql/migrations/V1__initial_schema.sql`（DDL only）
• `node ${CLAUDE_PLUGIN_ROOT}/lib/validate-ddl.mjs` 校验 DDL ↔ docs/03（5 维：表/列名/列类型/索引/FK），fail-closed
• `node ${CLAUDE_PLUGIN_ROOT}/lib/apply-ddl.mjs config-vars.yaml V1.sql`（解析 config-vars.yaml database: 段 + mysql2 apply，**无 shell-source**） | A3 | | A5 | `downstream-gen` | • 一次性生成 docs/02 / docs/05 / docs/10
• 回填 REQ 卡片依赖接口（`TBD(A5 自动补)` → 实际 endpoint）
• 追加模块清单到 docs/08 § 二
• **docs/05 + docs/02 评审闸**：用 `AskUserQuestion` 让用户确认 API 端点/字段无误 + 构建顺序可接受，未确认不勾 A5
• **prototype/ 门禁 + 推导 FE 清单写 docs/08 § 三**（原 A6 已并入；无 prototype 则问「无前端」→ § 三 留空）
• 最终占位符 + 结构残留扫描 | A4 | diff --git a/agents/code-reviewer.md b/agents/code-reviewer.md index e19ea8c..bfbcdd9 100644 --- a/agents/code-reviewer.md +++ b/agents/code-reviewer.md @@ -35,6 +35,7 @@ For each dimension below, classify Critical / Important / Suggestion as above. ### 2. Design Tokens (objective → can request-changes) - All color values MUST use `var(--color-*)` per `src/styles/tokens.css` (the single token source). Hard-coded hex / rgb → `request-changes` with file:line. - New tokens used in code without registration in `src/styles/tokens.css` → `request-changes`. +- Precedence — **tokens.css > prototype** for colors: if a prototype's literal color differs from the matching `tokens.css` token, using the token (not the prototype's raw color) is correct. Do NOT `request-changes` for a color that differs from the prototype as long as the right token is used. (Prototype governs structure/layout/interaction; tokens.css governs color.) ### 3. 无障碍 (Accessibility) — best-effort, flag-obvious-only - Form controls have `