@xulthekl/team-flow 0.54.0 → 0.56.0

package/skills/prototype/references/orchestration-flow.md

@@ -33,6 +33,14 @@
 
 环境简报显示设计系统缺失/不完整时：
 1. 主代理调用 `/team-flow:design-system` skill（独立入口，用户主导交互创建）。
+   > **传达范围（v0.55.0）**：只传 **① 环境简报里与"起点"相关的资产事实**，**不预选起点**——
+   > design-system 的 Step 0 会**无条件展示全部 7 条**（移植 / 模板库 / `--profile antd` / 文档导入 / 代码逆向 / 从零 / iterate）。
+   > 本侧无从判断用户手上有什么资产，**预选会让其余 6 条不可见**（能力存在但用户不知道 = 能力不存在）。
+   >
+   > 可传达的资产事实（由 scout 简报得出，**仅作提示、不代替用户选择**）：
+   > 简报含"已有符合规范的原型代码"→ 提示 `create-from-code` 可用；
+   > 需求方提到"有既有 UI 规范文档/规范树"→ 提示 `create-from-docs` 可用；
+   > 需求方提到"公司另一个后台项目已建过设计系统"→ 提示 clone 可用。
 2. design-system skill 内部执行：需求收集（≤5 个预填推荐问题）→ 确定性 token 派生 → 草稿生成（base.md + 变体）→ 预览生成（preview.html）→ 用户评审确认 → 落盘 `.team-flow/design-system/` + guard 校验。
 3. 创建完成后回 ① 补齐环境简报。
 

package/skills/workflow-bootstrap/SKILL.md

@@ -218,16 +218,26 @@ Step 2: 确定性提取（兜底）
 
 **不做的事**：不写 SOP 流程（由 skill 负责）、不写变更级状态机（由 workflow skill 负责）、不列可自动发现的文件清单。
 
-### B4.6: Design System 起点选择（advisory，v0.54.0 新增）
+### B4.6: Design System 起点选择（advisory，v0.54.0 新增；v0.55.0 扩为六项）
 
 > 编号说明：B4.5 已被占用（CLAUDE.md 初始化），本步骤为 B4.6。
 
-`.team-flow/design-system/` 不存在时，AskUserQuestion 呈现起点四选一（**不阻断**，延续 advisory 约定）：
+`.team-flow/design-system/` 不存在时，AskUserQuestion 呈现**起点六选一 + 跳过**（**不阻断**，延续 advisory 约定）：
 
-> 「检测到项目尚无设计系统。选择起点方式：[从模板库选择 | 逆向建库 | 从零创建 | 跳过]」
+> 「检测到项目尚无设计系统。选择起点方式：[移植已有设计系统 | 从模板库选择 | 通用起点（Ant Design 规格） | 从文档规范导入 | 从代码逆向建库 | 从零创建 | 跳过]」
 
-- **模板库**：调 `/team-flow:design-system`（起点=模板库）——由该 skill 呈现 `${CLAUDE_PLUGIN_ROOT}/templates/design-systems/registry.json`（8 个参考设计系统），选定后执行导入并**续跑 Step 5 评审 → Step 6 落盘**（含 primer 生成 + guard 校验）。**本步骤不直接调转换器**：转换器只产 base.md，缺少 primer 会让后续 prototype Step 0 对 `contract: v1` 系统直接 blocked（v0.54.0 P4 实证死路）
-- **逆向建库 / 从零创建**：调 `/team-flow:design-system`（create-from-code / 交互式 6 步）
+**六项全部展示，每项带适用场景一句话**——能力存在但用户不知道 = 能力不存在（v0.55.0 D-23）；按**资产就绪度降序**排列（从最厚的已有资产到最薄的空白起点）：
+
+| # | 起点 | 适用场景（对用户的一句话） | 委托给 design-system 时的参数 |
+|---|------|---------------------------|------------------------------|
+| 1 | **移植已有设计系统** | "你们公司**另一个后台项目**已经建过设计系统 → 直接复制过来改" | `clone --from <源路径>` |
+| 2 | **从模板库选择** | "想参考某个成熟产品（Linear / Stripe / Vercel…）的视觉风格" | 起点=模板库（呈现 `${CLAUDE_PLUGIN_ROOT}/templates/design-systems/registry.json` 的 8 个参考） |
+| 3 | **通用起点（Ant Design 规格）** | "全新项目、**没有任何规范**，先要一套像 Ant Design 的合规底座" | `--profile antd`（零 LLM） |
+| 4 | **从文档规范导入** | "手里有**一套写好的 UI 规范**（Markdown / 规范树）" | `create-from-docs` |
+| 5 | **从代码逆向建库** | "项目里**已有符合规范的原型代码**" | `create-from-code` |
+| 6 | **从零创建** | "什么都没有，边聊边定" | 交互式 6 步 |
+
+- **本步骤不直接调转换器**：六项**全部委托 `/team-flow:design-system`**，且必须**续跑 Step 5 评审 → Step 6 落盘**（含 primer 生成 + guard 校验）——转换器只产 base.md，缺少 primer 会让后续 prototype Step 0 对 `contract: v1` 系统直接 blocked（v0.54.0 P4 实证死路）
 - **跳过** → 继续 B5；**已存在** → 跳过
 
 ### B5: Path Decision（路径判断，v0.42.0 重构：降级路径设计）

package/src/parsing/requirement-blocks.ts

@@ -12,11 +12,40 @@ export interface RequirementsSectionParts {
   after: string;
 }
 
+/**
+ * 行内强调剥离 + 去反引号（v0.55.0 §8.4.3 横展；与 `scripts/lib/md-normalize.mjs` 同约定）。
+ *
+ * **根因**：解析层对最常见的 Markdown 强调语法脆弱且**失败静默**——手写
+ * `### **Requirement**: X` 或 `` ### `Requirement`: X `` 会让需求块整块漏解析，
+ * 而这条路径在 `tf sync`（→ `spec-merge` → 本模块）上是**活路径**，且
+ * `guard/checks/specs-merged` 会在 delta spec 存在时硬阻断 `executing → closing`。
+ * JS 侧已修（`md-normalize.mjs`），本函数是 TS 侧的对应实现（D-16「全修」）。
+ *
+ * **只剥双符号对**（`**` / `__`）：单 `*` 可能是列表符、单 `_` 可能是 snake_case
+ * 标识符——剥它们是"改语义"而非"容格式"。
+ */
+export function stripInlineEmphasis(text: string): string {
+  return text.replace(/`/g, '').replace(/\*\*(.+?)\*\*/g, '$1').replace(/__(.+?)__/g, '$1');
+}
+
+/** 归一化需求名：剥行内强调/反引号（名称本身被包裹时）+ trim。 */
 export function normalizeRequirementName(name: string): string {
-  return name.trim();
+  return stripInlineEmphasis(name).trim();
 }
 
-export const REQUIREMENT_HEADER_REGEX = /^###\s*Requirement:\s*(.+)\s*$/i;
+/**
+ * 需求块标题：`### Requirement: <name>`。
+ *
+ * v0.55.0 容忍：`Requirement` 键被加粗/反引号包裹（`**Requirement**` /
+ * `` `Requirement` `` / `` **`Requirement`** ``——**两种符号可任意交错、任意顺序**，
+ * 故用字符类而非固定序列）、全角冒号、冒号前后空格。
+ * 名称内的标记由 {@link normalizeRequirementName} 归一。
+ *
+ * 注：单 `*` 包裹（`*Requirement*`）也在容错内——键名两侧的星号无论一个两个
+ * 都是强调写法，剥它不改变语义。**需求名内部**的单符号才是语义边界，
+ * 由 `stripInlineEmphasis` 只剥成对双符号来保证。
+ */
+export const REQUIREMENT_HEADER_REGEX = /^###\s*[`*]{0,4}\s*Requirement\s*[`*]{0,4}\s*[:：]\s*(.+?)\s*$/i;
 
 function normalizeLineEndings(content: string): string {
   return content.replace(/\r\n?/g, '\n');
@@ -183,7 +212,7 @@ function parseRemovedNames(sectionBody: string): string[] {
       names.push(normalizeRequirementName(m[1]));
       continue;
     }
-    const bullet = line.match(/^\s*-\s*`?###\s*Requirement:\s*(.+?)`?\s*$/);
+    const bullet = line.match(/^\s*-\s*`?###\s*[`*]{0,4}\s*Requirement\s*[`*]{0,4}\s*[:：]\s*(.+?)\s*$/i);
     if (bullet) {
       names.push(normalizeRequirementName(bullet[1]));
     }
@@ -200,10 +229,10 @@ function parseRenamedPairs(
   let current: { from?: string; to?: string } = {};
   for (const line of lines) {
     const fromMatch = line.match(
-      /^\s*-?\s*FROM:\s*`?###\s*Requirement:\s*(.+?)`?\s*$/
+      /^\s*-?\s*FROM\s*[:：]\s*`?###\s*[`*]{0,4}\s*Requirement\s*[`*]{0,4}\s*[:：]\s*(.+?)\s*$/i
     );
     const toMatch = line.match(
-      /^\s*-?\s*TO:\s*`?###\s*Requirement:\s*(.+?)`?\s*$/
+      /^\s*-?\s*TO\s*[:：]\s*`?###\s*[`*]{0,4}\s*Requirement\s*[`*]{0,4}\s*[:：]\s*(.+?)\s*$/i
     );
     if (fromMatch) {
       current.from = normalizeRequirementName(fromMatch[1]);

package/src/validation/validator.ts

@@ -16,7 +16,14 @@ import {
   extractRequirementsSection,
 } from '../parsing/requirement-blocks.js';
 
-const REQUIREMENT_HEADER_REGEX = /^###\s*Requirement:\s*(.+)\s*$/i;
+// v0.55.0 §8.4.3（D-16「全修」横展）：本文件原有第二份 `REQUIREMENT_HEADER_REGEX`
+// 定义（`/^###\s*Requirement:\s*(.+)\s*$/i`）——**定义后从未使用**（本文件的需求头
+// 解析全部经 `parseDeltaSpec` / `extractRequirementsSection` 走解析层），属"同一契约
+// 两处定义"的维护陷阱：改解析层正则时无人知道这里还有一份。已删除，需求头正则的
+// 唯一真相源是 `parsing/requirement-blocks.ts`。
+//
+// ⚠️ 不要再在本文件内定义需求头/场景头以外格式约定的正则——场景头（下方）是
+// 本文件唯一自有的格式契约，其余一律从解析层引入。
 const SCENARIO_HEADER_REGEX = /^####\s+Scenario:/i;
 
 function normalizeLineEndings(content: string): string {