@deepstorm/cli 0.11.0 → 0.11.1

package/dist/skills/reef-gen-backend/variants/nodejs/steps.md

@@ -16,13 +16,13 @@
 
 每类文件必须包含以下注释（缺少则视为未完成）：
 
-| 文件类型 | 注释要求 |
-|---------|---------|
-| **Prisma Schema** | 每个 model 加 `/// 注释` 描述实体用途；每个字段加 `/// 注释` |
-| **DTO** | 类 JSDoc `/** 用途说明 */`；字段通过 `@ApiProperty({ description: '...' })` 提供文档 |
-| **Service** | 每个 public 方法加 JSDoc `/** 功能、@param、@returns */`；复杂逻辑内联注释说明 |
-| **Controller** | 每个端点加 `@ApiOperation({ summary: '...', description: '...' })` |
-| **Module** | 类 JSDoc `/** 模块职责 */` |
+| 文件类型          | 注释要求                                                                             |
+| ----------------- | ------------------------------------------------------------------------------------ |
+| **Prisma Schema** | 每个 model 加 `/// 注释` 描述实体用途；每个字段加 `/// 注释`                         |
+| **DTO**           | 类 JSDoc `/** 用途说明 */`；字段通过 `@ApiProperty({ description: '...' })` 提供文档 |
+| **Service**       | 每个 public 方法加 JSDoc `/** 功能、@param、@returns */`；复杂逻辑内联注释说明       |
+| **Controller**    | 每个端点加 `@ApiOperation({ summary: '...', description: '...' })`                   |
+| **Module**        | 类 JSDoc `/** 模块职责 */`                                                           |
 
 ## 安全红线
 

package/dist/skills/reef-gen-backend/variants/python/steps.md

@@ -50,13 +50,13 @@ app.include_router(orders.router, prefix="/api/v1/orders", tags=["orders"])
 
 每类文件必须包含以下注释（缺少则视为未完成）：
 
-| 文件类型 | 注释要求 |
-|---------|---------|
-| **Schema (Pydantic)** | 类 docstring 说明用途；关键字段用 `Field(description=...)`（会生成 OpenAPI 文档） |
-| **Model (SQLAlchemy)** | 类 docstring 说明表含义；复杂字段用 `comment=` 或行内注释说明 |
-| **Service** | 每个 public 函数加 docstring（Google 风格 `"""功能、Args、Returns"""`）；复杂逻辑行内注释 |
-| **Router** | 每个端点加 `summary=`/`description=` 参数或 docstring |
-| **Migration** | 每个 revision 加 docstring 说明变更意图 |
+| 文件类型               | 注释要求                                                                                  |
+| ---------------------- | ----------------------------------------------------------------------------------------- |
+| **Schema (Pydantic)**  | 类 docstring 说明用途；关键字段用 `Field(description=...)`（会生成 OpenAPI 文档）         |
+| **Model (SQLAlchemy)** | 类 docstring 说明表含义；复杂字段用 `comment=` 或行内注释说明                             |
+| **Service**            | 每个 public 函数加 docstring（Google 风格 `"""功能、Args、Returns"""`）；复杂逻辑行内注释 |
+| **Router**             | 每个端点加 `summary=`/`description=` 参数或 docstring                                     |
+| **Migration**          | 每个 revision 加 docstring 说明变更意图                                                   |
 
 ## ⚠️ 异步红线
 

package/dist/skills/reef-gen-frontend/variants/angular/steps.md

@@ -11,12 +11,12 @@
 
 ## 注释要求
 
-| 文件类型 | 注释要求 |
-|---------|---------|
-| **类型定义** | 复杂类型加行内注释说明字段含义 |
-| **Service** | 简要说明每个方法的功能和返回类型 |
+| 文件类型      | 注释要求                                 |
+| ------------- | ---------------------------------------- |
+| **类型定义**  | 复杂类型加行内注释说明字段含义           |
+| **Service**   | 简要说明每个方法的功能和返回类型         |
 | **Component** | 关键组件加注释说明用途；复杂逻辑行内注释 |
-| **路由** | 无需额外注释 |
+| **路由**      | 无需额外注释                             |
 
 ## 核心约束
 

package/dist/skills/reef-gen-frontend/variants/react/steps.md

@@ -11,12 +11,12 @@
 
 ## 注释要求
 
-| 文件类型 | 注释要求 |
-|---------|---------|
-| **类型定义** | 复杂类型加行内注释说明字段含义 |
-| **API Hook** | 简要说明该 Hook 的功能和返回值 |
-| **组件** | 关键组件加注释说明用途；复杂逻辑行内注释 |
-| **页面** | 无需额外注释 |
+| 文件类型     | 注释要求                                 |
+| ------------ | ---------------------------------------- |
+| **类型定义** | 复杂类型加行内注释说明字段含义           |
+| **API Hook** | 简要说明该 Hook 的功能和返回值           |
+| **组件**     | 关键组件加注释说明用途；复杂逻辑行内注释 |
+| **页面**     | 无需额外注释                             |
 
 ## 核心约束
 

package/dist/skills/reef-gen-frontend/variants/vue/steps.md

@@ -11,12 +11,12 @@
 
 ## 注释要求
 
-| 文件类型 | 注释要求 |
-|---------|---------|
-| **类型定义** | 复杂类型加行内注释说明字段含义 |
-| **组合式函数** | 简要说明该函数的功能和返回值 |
-| **组件** | 关键组件加注释说明用途；复杂逻辑行内注释 |
-| **页面** | 无需额外注释 |
+| 文件类型       | 注释要求                                 |
+| -------------- | ---------------------------------------- |
+| **类型定义**   | 复杂类型加行内注释说明字段含义           |
+| **组合式函数** | 简要说明该函数的功能和返回值             |
+| **组件**       | 关键组件加注释说明用途；复杂逻辑行内注释 |
+| **页面**       | 无需额外注释                             |
 
 ## 核心约束
 

package/dist/skills/reef-harden/EXAMPLES.md

@@ -14,6 +14,7 @@ proposal.md 的 Scope 段列出了 21 条要做的功能，但没有一条"不
 
 ```markdown
 ## 不做什么
+
 - 仅支持 Scope 中列出的控件类型（TextControl、NumberControl、DateTimeControl、
   ChoiceControl、ObjectControl），其余控件均不在本版本支持范围内
 - 不支持批量导入（不支持一次上传多个 Excel 文件）
@@ -37,6 +38,7 @@ spec.md 末尾新增：
 
 ```markdown
 ## Known Limitations
+
 本版本存在以下已知约束：
 
 - **仅支持新增**：导入操作仅创建新的 FormResponse，不支持通过
@@ -61,16 +63,16 @@ spec.md 末尾新增：
 
 ```markdown
 - [x] 7.1 `FormExportServiceTest`：测试 Excel 生成逻辑（表头必填标记、
-  填写说明行、下拉验证、隐藏 Sheet、Sheet 保护）
+      填写说明行、下拉验证、隐藏 Sheet、Sheet 保护）
 ```
 
 ### 加固后
 
 ```markdown
 - [x] 7.1 `FormExportServiceTest`：覆盖 TextControl / NumberControl /
-  DateTimeControl / ChoiceControl（PredefinedOptionsSource + DatasetOptionsSource）
-  / ObjectControl 五种控件导出；验证标题行必填标记 *、填写说明行、_meta Sheet
-  的 revisionId 与 key 顺序、Sheet VERY_HIDDEN + 保护、白名单过滤、空字段报错
+      DateTimeControl / ChoiceControl（PredefinedOptionsSource + DatasetOptionsSource）
+      / ObjectControl 五种控件导出；验证标题行必填标记 *、填写说明行、_meta Sheet
+      的 revisionId 与 key 顺序、Sheet VERY_HIDDEN + 保护、白名单过滤、空字段报错
 ```
 
 关键动作：将"测试 X"的许愿式描述替换为场景覆盖清单。
@@ -81,9 +83,9 @@ spec.md 末尾新增：
 
 加固过程中发现的数字：
 
-| 数字 | 处理方式 | 理由 |
-|------|---------|------|
-| 5MB / 3000行 / 200列 | **不修改** | 业务指标，用户确认 |
-| #3B82F6 / #22C55E 等颜色 | **不修改** | 有引用来源（Figma） |
-| w-225（对话框宽度） | **不修改** | 设计稿尺寸，可追溯 |
-| application.properties vs .yaml | **修正** | 项目实际使用 yaml，文档写错 |
+| 数字                            | 处理方式   | 理由                        |
+| ------------------------------- | ---------- | --------------------------- |
+| 5MB / 3000行 / 200列            | **不修改** | 业务指标，用户确认          |
+| #3B82F6 / #22C55E 等颜色        | **不修改** | 有引用来源（Figma）         |
+| w-225（对话框宽度）             | **不修改** | 设计稿尺寸，可追溯          |
+| application.properties vs .yaml | **修正**   | 项目实际使用 yaml，文档写错 |

package/dist/skills/reef-harden/SKILL.md

@@ -19,6 +19,7 @@ node packages/reef/skills/reef-harden/scripts/find-change-dir.mjs
 输出 JSON。`noMatch: true` 时需让用户选择；有 `suggestion` 时使用推荐 change。
 
 如需并列出 SDD 文档路径：
+
 ```bash
 node packages/reef/skills/reef-harden/scripts/find-change-dir.mjs --files
 ```
@@ -60,6 +61,7 @@ openspec/changes/<change>/
 #### 第一道筛：特定数字
 
 搜索文档中所有具体数字（5MB、3000、80%、100ms 等），逐一判断：
+
 - 有引用来源（benchmark、SLA、Figma 等）→ 通过
 - 无引用来源 → 标注 TBD 或在旁边加上 Rationale 说明理由
 - 禁止让"看起来合理但无根据"的数字留在文档里
@@ -67,10 +69,12 @@ openspec/changes/<change>/
 #### 第二道筛："不做什么"
 
 检查是否存在 `## 不做什么` / `## Out of Scope` 段：
+
 - 若不存在 → 必须新增
 - 若存在但内容敷衍（< 5 条）→ 用反向提问扩充："这个功能在第一版里应该不做什么？"
 
 至少应覆盖：
+
 - 不支持的功能/控件/场景（明确列出）
 - 第一版 scale 边界（并发、文件大小、批量操作等）
 - 是 permanent out 还是 v2 做（标注）
@@ -78,6 +82,7 @@ openspec/changes/<change>/
 #### 第三道筛：验证方法
 
 检查所有验证要求，确保每一条可执行：
+
 - "定期 review" → 不合格，追问为"谁、频率、用什么工具"
 - "写测试" → 不合格，细化为"FormExportServiceTest：覆盖 X/Y/Z 场景"
 - 每条验证应对应一个 CI 命令或具体测试步骤
@@ -110,6 +115,7 @@ openspec/changes/<change>/
 ### Step 3: 沉淀 Known Limitations
 
 在 proposal.md 末尾添加 `## Known Limitations` 段，内容来源：
+
 1. 第二步"不做什么"中标注的边界
 2. 第四步反向 grill 中不可忽视的风险点
 3. 已知但有意推迟的 trade-off

package/dist/skills/reef-harden/scripts/find-change-dir.mjs

@@ -31,9 +31,7 @@ function isArchivePath(changePath) {
  * @returns {object|null}
  */
 export function findChangeByName(changes, name) {
-  return changes.find(c =>
-    c.name === name && !isArchivePath(c.path)
-  ) || null;
+  return changes.find((c) => c.name === name && !isArchivePath(c.path)) || null;
 }
 
 /**
@@ -42,7 +40,7 @@ export function findChangeByName(changes, name) {
  * @returns {object|null}
  */
 export function findMostRecent(changes) {
-  const active = changes.filter(c => !c.archived);
+  const active = changes.filter((c) => !c.archived);
   if (active.length === 0) return null;
   return active.sort((a, b) => b.mtimeMs - a.mtimeMs)[0];
 }
@@ -115,9 +113,10 @@ find-change-dir.mjs — 发现 OpenSpec change 目录
     process.exit(0);
   }
 
-  const root = process.argv.indexOf('--dir') >= 0
-    ? process.argv[process.argv.indexOf('--dir') + 1]
-    : process.env.INIT_CWD || process.cwd();
+  const root =
+    process.argv.indexOf('--dir') >= 0
+      ? process.argv[process.argv.indexOf('--dir') + 1]
+      : process.env.INIT_CWD || process.cwd();
   const changesDir = join(root, CHANGES_GLOB);
   const allChanges = listChanges(changesDir);
 
@@ -137,9 +136,7 @@ find-change-dir.mjs — 发现 OpenSpec change 目录
   } else {
     const branch = execGitBranch();
     result = branch
-      ? (findChangeByName(allChanges, branch) ||
-         { noMatch: true, branch,
-           suggestion: findMostRecent(allChanges) })
+      ? findChangeByName(allChanges, branch) || { noMatch: true, branch, suggestion: findMostRecent(allChanges) }
       : { noMatch: true, allChanges };
   }
 
@@ -148,9 +145,12 @@ find-change-dir.mjs — 发现 OpenSpec change 目录
 
 function execGitBranch() {
   try {
-    return execSync('git branch --show-current', {
-      encoding: 'utf8', timeout: 5000,
-    }).trim() || null;
+    return (
+      execSync('git branch --show-current', {
+        encoding: 'utf8',
+        timeout: 5000,
+      }).trim() || null
+    );
   } catch {
     return null;
   }

package/dist/skills/reef-pr/SKILL.md

@@ -43,13 +43,20 @@ node packages/reef/skills/reef-pr/scripts/create-pr.mjs --collect
 
 ```markdown
 ## 概要
+
 {2-4 行概括变更动机，优先从 proposal.md 提取}
+
 ## 关联
+
 JIRA: {commit body / proposal.md / jira-start 元数据}
 OpenSpec: openspec/changes/{branch-name}/
+
 ## 变更清单
+
 {git diff --stat 输出}
+
 ## 测试计划
+
 - [ ] {前端路径含 src/main/web/ 则加}
 - [ ] {后端路径含 src/main/java/ 则加}
 - [ ] {手动验证步骤，如有}

package/dist/skills/reef-pr/scripts/create-pr.mjs

@@ -40,13 +40,13 @@ export function buildPrBody(ctx) {
     lines.push(`Changes: ${s.files} 文件, +${s.insertions}/-${s.deletions}`);
     lines.push('');
     lines.push('## 变更清单');
-    s.changedFiles.forEach(f => lines.push(`- \`${f}\``));
+    s.changedFiles.forEach((f) => lines.push(`- \`${f}\``));
   }
 
   if (ctx.commitLog && ctx.commitLog.length > 0) {
     lines.push('');
     lines.push('## Commits');
-    ctx.commitLog.forEach(c => lines.push(`- ${c.hash} ${c.message}`));
+    ctx.commitLog.forEach((c) => lines.push(`- ${c.hash} ${c.message}`));
   }
 
   return lines.join('\n');
@@ -74,27 +74,18 @@ function exec(command) {
 
 function collectContext() {
   const branch = exec('git branch --show-current');
-  const forkPoint = exec(
-    'git merge-base main HEAD 2>/dev/null || echo ""'
-  );
-  const diffStat = exec(
-    `git diff "${forkPoint || 'main'}..HEAD" --stat`
-  );
-  const commitLog = forkPoint
-    ? exec(`git log "${forkPoint}"..HEAD --oneline`)
-    : '';
+  const forkPoint = exec('git merge-base main HEAD');
+  const diffStat = exec(`git diff "${forkPoint || 'main'}..HEAD" --stat`);
+  const commitLog = forkPoint ? exec(`git log "${forkPoint}"..HEAD --oneline`) : '';
   const statusShort = exec('git status --short');
 
   // 查找关联 proposal
   let proposalTitle = '';
-  const root = exec(
-    'git rev-parse --show-toplevel 2>/dev/null || echo ""'
-  );
+  const root = exec('git rev-parse --show-toplevel');
   if (root && branch) {
     const p = join(root, 'openspec', 'changes', branch, 'proposal.md');
     if (existsSync(p)) {
-      const firstLine = readFileSync(p, 'utf8')
-        .split('\n')[0] || '';
+      const firstLine = readFileSync(p, 'utf8').split('\n')[0] || '';
       proposalTitle = firstLine.replace(/^#+\s*/, '').trim();
     }
   }
@@ -104,10 +95,14 @@ function collectContext() {
     hasUncommitted: checkUncommitted(statusShort),
     proposalTitle,
     commitLog: commitLog
-      ? commitLog.split('\n').filter(Boolean).map(l => {
-          const m = l.match(/^(\S+)\s+(.*)/);
-          return m ? { hash: m[1], message: m[2] } : null;
-        }).filter(Boolean)
+      ? commitLog
+          .split('\n')
+          .filter(Boolean)
+          .map((l) => {
+            const m = l.match(/^(\S+)\s+(.*)/);
+            return m ? { hash: m[1], message: m[2] } : null;
+          })
+          .filter(Boolean)
       : [],
     diffStat: diffStat ? parseDiffStat(diffStat) : null,
   };
@@ -116,7 +111,9 @@ function collectContext() {
 function parseDiffStat(output) {
   const lines = output.trim().split('\n').filter(Boolean);
   const changedFiles = [];
-  let files = 0, insertions = 0, deletions = 0;
+  let files = 0,
+    insertions = 0,
+    deletions = 0;
 
   for (const line of lines) {
     const sm = line.match(/(\d+)\s+files?\s+changed/);
@@ -136,7 +133,7 @@ function parseDiffStat(output) {
 }
 
 function checkExistingPR() {
-  const out = exec('gh pr view --json url 2>/dev/null || true');
+  const out = exec('gh pr view --json url');
   return out ? { exists: true, url: out } : { exists: false };
 }
 
@@ -187,7 +184,7 @@ create-pr.mjs — PR 上下文收集与创建
     }
 
     const branch = exec('git branch --show-current');
-    const pushOut = exec(`git push -u origin ${branch} 2>&1`);
+    const pushOut = exec(`git push -u origin ${branch}`);
     if (!pushOut) {
       console.error('git push 失败');
       process.exit(1);
@@ -197,17 +194,22 @@ create-pr.mjs — PR 上下文收集与创建
       title: process.argv[titleArg + 1],
       body: process.argv[bodyArg + 1],
       branch,
-      reviewer: reviewerArg >= 0
-        ? process.argv[reviewerArg + 1] : null,
+      reviewer: reviewerArg >= 0 ? process.argv[reviewerArg + 1] : null,
       label: labelArg >= 0 ? process.argv[labelArg + 1] : null,
       draft: isDraft,
     });
 
     const out = exec(cmd);
-    process.stdout.write(JSON.stringify({
-      created: true,
-      url: out,
-    }, null, 2) + '\n');
+    process.stdout.write(
+      JSON.stringify(
+        {
+          created: true,
+          url: out,
+        },
+        null,
+        2,
+      ) + '\n',
+    );
     process.exit(0);
   }
 

package/dist/skills/reef-scope/SKILL.md

@@ -116,12 +116,12 @@ scope-check:
 
 ## 环境变量
 
-| 变量 | 默认值 | 说明 |
-|------|--------|------|
-| `ANTHROPIC_API_KEY` | — | Claude API Key（优先使用） |
-| `OPENAI_API_KEY` | — | OpenAI API Key（备选） |
-| `LLM_MODEL` | `claude-sonnet-4-20250514` | 使用的模型 |
-| `MAX_DIFF_CHARS` | 20000 | diff 截断字符数 |
+| 变量                | 默认值                     | 说明                       |
+| ------------------- | -------------------------- | -------------------------- |
+| `ANTHROPIC_API_KEY` | —                          | Claude API Key（优先使用） |
+| `OPENAI_API_KEY`    | —                          | OpenAI API Key（备选）     |
+| `LLM_MODEL`         | `claude-sonnet-4-20250514` | 使用的模型                 |
+| `MAX_DIFF_CHARS`    | 20000                      | diff 截断字符数            |
 
 ## 常见问题
 

package/dist/skills/reef-start/references/jira-start-subagent.md

@@ -3,6 +3,7 @@
 > **⚠️ 本文件已被 `SKILL.md.tmpl` 中的 TDD（Red → Green → Refactor）实现流程替代。**
 >
 > 原阶段五（现阶段四）的子代理 A→E 编码循环已移除，替换为：
+>
 > - 逐 task TDD 循环（RED → GREEN → REFACTOR）
 > - 纯配置/文档/SKILL.md 豁免 TDD
 > - 详见 SKILL.md.tmpl 的「阶段四：TDD 实现」
@@ -11,7 +12,6 @@
 
 ---
 
-
 ## 步骤 A：构造子代理 prompt
 
 组合以下上下文发送给子代理：
@@ -32,12 +32,12 @@
 
 使用 `Agent` 工具（type: `"general-purpose"`），prompt 为步骤 A 构造的内容。
 
-| 返回状态 | 处理 |
-|---------|------|
-| **DONE** | 继续步骤 C |
-| **DONE_WITH_CONCERNS** | 阅读疑虑。涉及正确性则先修复；仅观察则记录后继续 |
-| **NEEDS_CONTEXT** | 补充上下文后重新派遣 |
-| **BLOCKED** | context 不足→补充；task 过大→拆分；plan 错误→告知用户 |
+| 返回状态               | 处理                                                  |
+| ---------------------- | ----------------------------------------------------- |
+| **DONE**               | 继续步骤 C                                            |
+| **DONE_WITH_CONCERNS** | 阅读疑虑。涉及正确性则先修复；仅观察则记录后继续      |
+| **NEEDS_CONTEXT**      | 补充上下文后重新派遣                                  |
+| **BLOCKED**            | context 不足→补充；task 过大→拆分；plan 错误→告知用户 |
 
 ## 步骤 C：Spec 合规审查
 

package/dist/skills/reef-start/references/risk-routing-card.md

@@ -6,22 +6,22 @@
 
 ## 风险因子 → Mode 对照表
 
-| 变更类型 | 示例 | 推荐 Mode | 依据 |
-|---------|------|-----------|------|
-| 文档修改 | `.md` 文件内容调整、注释修改 | **plan** | 无行为逻辑，直接可验证 |
-| 配置文件 | `.json` / `.yaml` / `.toml` 配置项调整 | **plan** | 结构确定，验证成本低 |
-| SKILL.md / 流程文档 | 流程描述修改、检查清单增删 | **plan** | 纯文档，无运行时行为 |
-| 测试框架基础设施搭建 | 初始化 vitest / jest / pytest 配置 | **plan** | 脚手架性质，无业务逻辑 |
-| 简单重构（测试覆盖充分） | 提取函数、重命名、移动文件 | **plan** | 已有测试覆盖（>80%）可验证 |
-| 简单重构（测试覆盖不足） | 同上但测试覆盖 < 80% | **tdd** | 需先补测试再重构 |
-| 新增业务逻辑 | Controller / Service / Repository 新增 | **tdd** | 行为变更需先写测试 |
-| Bug 修复 | 功能缺陷修复 | **tdd** | 先写回归测试再修复 |
-| 权限 / 安全变更 | 权限校验、鉴权逻辑、数据脱敏 | **tdd** | 高风险，需完整测试覆盖 |
-| 资金 / 计费变更 | 金额计算、支付流程、账单生成 | **tdd** | 高风险，需完整测试覆盖，标记高优先级 |
-| 幂等性 / 数据库迁移 | 数据库脚本、数据迁移、重入逻辑 | **tdd** | 幂等性需严格验证 |
-| 状态机逻辑 | 状态流转、事件驱动 | **tdd** | 状态组合复杂，需全覆盖 |
-| 并发 / 异步逻辑 | 线程、协程、消息队列消费 | **tdd** | 竞态条件需测试验证 |
-| 不确定风险等级 | 无法明确归类 | **默认 auto** | Agent 推荐后人工确认 |
+| 变更类型                 | 示例                                   | 推荐 Mode     | 依据                                 |
+| ------------------------ | -------------------------------------- | ------------- | ------------------------------------ |
+| 文档修改                 | `.md` 文件内容调整、注释修改           | **plan**      | 无行为逻辑，直接可验证               |
+| 配置文件                 | `.json` / `.yaml` / `.toml` 配置项调整 | **plan**      | 结构确定，验证成本低                 |
+| SKILL.md / 流程文档      | 流程描述修改、检查清单增删             | **plan**      | 纯文档，无运行时行为                 |
+| 测试框架基础设施搭建     | 初始化 vitest / jest / pytest 配置     | **plan**      | 脚手架性质，无业务逻辑               |
+| 简单重构（测试覆盖充分） | 提取函数、重命名、移动文件             | **plan**      | 已有测试覆盖（>80%）可验证           |
+| 简单重构（测试覆盖不足） | 同上但测试覆盖 < 80%                   | **tdd**       | 需先补测试再重构                     |
+| 新增业务逻辑             | Controller / Service / Repository 新增 | **tdd**       | 行为变更需先写测试                   |
+| Bug 修复                 | 功能缺陷修复                           | **tdd**       | 先写回归测试再修复                   |
+| 权限 / 安全变更          | 权限校验、鉴权逻辑、数据脱敏           | **tdd**       | 高风险，需完整测试覆盖               |
+| 资金 / 计费变更          | 金额计算、支付流程、账单生成           | **tdd**       | 高风险，需完整测试覆盖，标记高优先级 |
+| 幂等性 / 数据库迁移      | 数据库脚本、数据迁移、重入逻辑         | **tdd**       | 幂等性需严格验证                     |
+| 状态机逻辑               | 状态流转、事件驱动                     | **tdd**       | 状态组合复杂，需全覆盖               |
+| 并发 / 异步逻辑          | 线程、协程、消息队列消费               | **tdd**       | 竞态条件需测试验证                   |
+| 不确定风险等级           | 无法明确归类                           | **默认 auto** | Agent 推荐后人工确认                 |
 
 ## Plan Mode 决定性特征
 
@@ -36,15 +36,15 @@
 
 ## Plan vs TDD 执行策略差异表
 
-| 维度 | Plan Mode | TDD Mode |
-|------|-----------|----------|
-| **实现前** | 直接实现 | 🔴 先写测试（RED） |
-| **实现中** | 持续关注复杂度超预期信号 | 🟢 写最小实现代码 |
-| **后置验证** | build → lint → test **必须全过** | 🔵 重构 → build → lint → test |
-| **验证失败处理** | 修复后重新验证，通过才标完成 | 同左 |
-| **测试编写** | 后置验证阶段不要求新测试 | 前置 RED 阶段已完成 |
-| **代码审查** | 同标准 code-audit | 同标准 code-audit |
-| **复杂度超预期** | 主动升级为 tdd mode | 不允许降级 |
+| 维度             | Plan Mode                        | TDD Mode                      |
+| ---------------- | -------------------------------- | ----------------------------- |
+| **实现前**       | 直接实现                         | 🔴 先写测试（RED）            |
+| **实现中**       | 持续关注复杂度超预期信号         | 🟢 写最小实现代码             |
+| **后置验证**     | build → lint → test **必须全过** | 🔵 重构 → build → lint → test |
+| **验证失败处理** | 修复后重新验证，通过才标完成     | 同左                          |
+| **测试编写**     | 后置验证阶段不要求新测试         | 前置 RED 阶段已完成           |
+| **代码审查**     | 同标准 code-audit                | 同标准 code-audit             |
+| **复杂度超预期** | 主动升级为 tdd mode              | 不允许降级                    |
 
 ## 模式选择规则
 
@@ -53,6 +53,7 @@
 Agent 在 plan mode 实现过程中，如发现变更复杂度超出预期（涉及多模块联动、边界条件复杂、异常路径多），**SHALL 主动暂停**，向用户声明并建议升级为 tdd mode。用户确认后方可切换。
 
 **升级信号：**
+
 - 实现时发现需要修改 3+ 个模块
 - 发现隐藏的边界条件或并发问题
 - 发现现有测试覆盖率不足且无法目视确认正确性
@@ -63,6 +64,7 @@ Agent 在 plan mode 实现过程中，如发现变更复杂度超出预期（涉
 一旦 superpowers 门禁判定为 tdd mode，Agent **SHALL NOT** 以任何理由降级为 plan mode。即使实现过程中发现变更比预期简单，也必须完成完整的 RED→GREEN→REFACTOR 循环。
 
 **常见违规场景（禁止）：**
+
 - "这个 task 其实很简单，直接改吧" → ❌ 违规
 - "测试已经覆盖了，不写新测试直接改" → ❌ 违规（对于 tdd mode task）
 - "现在补测试太慢，先改后面再补" → ❌ 违规
@@ -70,6 +72,7 @@ Agent 在 plan mode 实现过程中，如发现变更复杂度超出预期（涉
 ### 规则 3：默认 auto 模式
 
 风险路由**默认自动推荐**。Agent 在 superpowers 门禁中：
+
 1. 根据变更类型和风险因子，输出风险判断表 + 推荐模式 + 推荐理由
 2. **等待用户确认后**，方可进入阶段四