@wenaixi/dsh-superpower 7.0.0 → 7.0.1

package/lib/superpowers.js

@@ -5,12 +5,14 @@
  * 通过 ctx.skills.registerProvider 注入全局层，rank 10 使本插件技能优先级最高：
  * 小于 dsh-skill-filesystem 的项目/用户根（100–500）与官方 bundled（600）。
  */
-import { readdir, readFile, stat } from 'node:fs/promises';
-import { dirname, join, resolve } from 'node:path';
+import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { parse } from 'yaml';
-import { isSkillName } from '@deepseek-ai/dsh-skill';
 import Schema from '@deepseek-ai/schemastery';
+import { SkillCatalog } from './catalog.js';
+import { SkillDocument } from './document.js';
+// 具名导出深度模块，为验证治理与测试表面提供统一深度接口
+export { SkillCatalog } from './catalog.js';
+export { SkillDocument } from './document.js';
 // ---------------------------------------------------------------------------
 // Config — 默认值写在 schema 里；可选字段用可选属性声明
 // ---------------------------------------------------------------------------
@@ -26,7 +28,7 @@ export const Config = Schema.object({
 export const name = 'superpowers';
 export const inject = ['skills'];
 // ---------------------------------------------------------------------------
-// 工具函数
+// 常量与校验
 // ---------------------------------------------------------------------------
 // 本插件技能优先级最高：rank 值越小优先级越高（官方注册表升序裁决），
 // 10 低于 filesystem 项目/用户根(100–500) 与官方 bundled(600)。
@@ -37,92 +39,6 @@ function assertNotRuntimeProvider(providerName) {
         throw new Error(`[superpowers] providerName "${RUNTIME_PROVIDER}" 为保留名，不可用`);
     }
 }
-function stringField(data, key) {
-    const v = data[key];
-    return typeof v === 'string' && v.length > 0 ? v : undefined;
-}
-function optionalString(data, key) {
-    const v = data[key];
-    return typeof v === 'string' && v.length > 0 ? { [key]: v } : {};
-}
-function frontmatterBoolean(data, key) {
-    if (!Object.hasOwn(data, key))
-        return undefined;
-    const v = data[key];
-    if (typeof v === 'boolean')
-        return v;
-    if (v === 1 || v === '1')
-        return true;
-    if (v === 0 || v === '0')
-        return false;
-    if (typeof v === 'string') {
-        switch (v.toLowerCase()) {
-            case 'true':
-            case 'yes':
-            case 'on':
-                return true;
-            case 'false':
-            case 'no':
-            case 'off':
-                return false;
-        }
-    }
-    throw new TypeError(`frontmatter field "${key}" must be a boolean`);
-}
-function rejectLegacyKey(data, legacy, canonical) {
-    if (Object.hasOwn(data, legacy)) {
-        throw new Error(`frontmatter field "${legacy}" is unsupported; use "${canonical}"`);
-    }
-}
-function parseInvocationPolicy(data) {
-    rejectLegacyKey(data, 'disableModelInvocation', 'disable-model-invocation');
-    rejectLegacyKey(data, 'modelInvocable', 'disable-model-invocation');
-    rejectLegacyKey(data, 'userInvocable', 'user-invocable');
-    const disableModelInvocation = frontmatterBoolean(data, 'disable-model-invocation');
-    const userInvocable = frontmatterBoolean(data, 'user-invocable');
-    return {
-        modelInvocable: disableModelInvocation !== true,
-        userInvocable: userInvocable !== false,
-    };
-}
-function optionalMetadata(data) {
-    const v = data['metadata'];
-    if (typeof v === 'object' && v !== null && !Array.isArray(v))
-        return { metadata: v };
-    return {};
-}
-function findClosingFrontmatter(raw, start) {
-    let lineStart = start;
-    while (lineStart <= raw.length) {
-        const nl = raw.indexOf('\n', lineStart);
-        const lineEnd = nl < 0 ? raw.length : nl;
-        if (raw.slice(lineStart, lineEnd).replace(/\r$/, '') === '---') {
-            return { start: lineStart, bodyStart: nl < 0 ? raw.length : nl + 1 };
-        }
-        if (nl < 0)
-            return undefined;
-        lineStart = nl + 1;
-    }
-    return undefined;
-}
-function parseFrontmatter(raw) {
-    // 去 BOM：Windows 编辑器易带 \uFEFF，导致首行非 --- 而被静默跳过
-    if (raw.charCodeAt(0) === 0xfeff)
-        raw = raw.slice(1);
-    const firstNl = raw.indexOf('\n');
-    if (firstNl < 0)
-        return undefined;
-    if (raw.slice(0, firstNl).replace(/\r$/, '') !== '---')
-        return undefined;
-    const start = firstNl + 1;
-    const closing = findClosingFrontmatter(raw, start);
-    if (!closing)
-        return undefined;
-    const parsed = parse(raw.slice(start, closing.start));
-    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
-        return undefined;
-    return { data: parsed, body: raw.slice(closing.bodyStart) };
-}
 function resolveDefaultSkillDir(configSkillDir) {
     if (configSkillDir)
         return resolve(configSkillDir);
@@ -132,175 +48,32 @@ function resolveDefaultSkillDir(configSkillDir) {
     return resolve(dirname(here), '..', 'skills');
 }
 // ---------------------------------------------------------------------------
-// Provider
+// Provider 实现 — 纯调度与生命周期治理，具体编目、快照与文档解析委托给 SkillCatalog 深度模块
 // ---------------------------------------------------------------------------
 class SuperpowersProvider {
     name;
-    skillDir;
+    catalog;
     ctx;
     constructor(ctx, _control, config) {
         assertNotRuntimeProvider(config.providerName);
         this.ctx = ctx;
         this.name = config.providerName;
-        this.skillDir = resolveDefaultSkillDir(config.skillDir);
+        const skillDir = resolveDefaultSkillDir(config.skillDir);
+        this.catalog = new SkillCatalog(skillDir);
     }
     async list(options) {
-        options.signal?.throwIfAborted();
-        const candidates = [];
-        const seen = new Set();
-        let entries;
-        try {
-            entries = await readdir(this.skillDir, { withFileTypes: true, signal: options.signal });
-        }
-        catch (err) {
-            const code = err?.code;
-            if (code === 'ENOENT' || code === 'ENOTDIR') {
-                this.ctx.logger.warn(`[superpowers] skillDir not found: ${this.skillDir}`);
-                return [];
-            }
-            throw err;
-        }
-        for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
-            options.signal?.throwIfAborted();
-            if (!entry.isDirectory())
-                continue;
-            if (entry.name.startsWith('.'))
-                continue;
-            const skillPath = join(this.skillDir, entry.name, 'SKILL.md');
-            try {
-                await stat(skillPath);
-            }
-            catch (err) {
-                const code = err?.code;
-                this.ctx.logger.debug(`[superpowers] skip ${entry.name}: no SKILL.md (${code ?? String(err)})`);
-                continue;
-            }
-            let parsed;
-            try {
-                parsed = await parseSkillFile(skillPath);
-            }
-            catch (err) {
-                this.ctx.logger.warn(`[superpowers] skip ${skillPath}: YAML 解析失败 — ${String(err)}`);
-                continue;
-            }
-            if (!parsed) {
-                this.ctx.logger.warn(`[superpowers] skip ${entry.name}: missing or invalid frontmatter`);
-                continue;
-            }
-            const { data } = parsed;
-            const skillName = stringField(data, 'name');
-            const description = stringField(data, 'description');
-            if (!skillName || !description) {
-                this.ctx.logger.warn(`[superpowers] skip ${skillPath}: frontmatter requires name and description`);
-                continue;
-            }
-            if (!isSkillName(skillName)) {
-                this.ctx.logger.warn(`[superpowers] skip ${skillPath}: invalid skill name "${skillName}"`);
-                continue;
-            }
-            if (seen.has(skillName)) {
-                this.ctx.logger.warn(`[superpowers] skip ${skillPath}: duplicate skill name "${skillName}"`);
-                continue;
-            }
-            // 目录名与 skill name 不一致时以 frontmatter 为准，但打印提示
-            if (skillName !== entry.name) {
-                this.ctx.logger.warn(`[superpowers] skill name "${skillName}" != directory "${entry.name}" (using frontmatter)`);
-            }
-            let invocation;
-            try {
-                invocation = parseInvocationPolicy(data);
-            }
-            catch (e) {
-                this.ctx.logger.warn(`[superpowers] skip ${skillPath}: ${String(e)}`);
-                continue;
-            }
-            seen.add(skillName);
-            candidates.push({
-                name: skillName,
-                description,
-                ...optionalString(data, 'whenToUse'),
-                invocation,
-                source: 'bundled',
-                provider: this.name,
-                rank: SUPERPOWERS_RANK,
-                locator: { path: skillPath, directory: dirname(skillPath) },
-                resourceBase: { kind: 'directory', path: dirname(skillPath) },
-                path: skillPath,
-                ...optionalMetadata(data),
-            });
-        }
-        return candidates;
+        return this.catalog.listCandidates(this.name, SUPERPOWERS_RANK, {
+            signal: options.signal,
+            logger: this.ctx.logger,
+        });
     }
     async get(candidate, options) {
-        options.signal?.throwIfAborted();
-        const locator = candidate.locator;
-        if (!locator?.path || !locator?.directory)
-            return undefined;
-        let raw;
-        try {
-            raw = await readFile(locator.path, {
-                encoding: 'utf8',
-                signal: options.signal,
-            });
-        }
-        catch (err) {
-            if (err?.name === 'AbortError')
-                throw err;
-            const code = err?.code;
-            if (code === 'ENOENT')
-                return undefined;
-            this.ctx.logger.warn(`[superpowers] get ${candidate.name}: read failed (${code ?? String(err)})`);
-            return undefined;
-        }
-        if (raw === undefined)
-            return undefined;
-        options.signal?.throwIfAborted();
-        const parsed = parseFrontmatter(raw);
-        if (!parsed) {
-            this.ctx.logger.warn(`[superpowers] get ${candidate.name}: missing or invalid frontmatter`);
-            return undefined;
-        }
-        const data = parsed.data;
-        const skillName = stringField(data, 'name');
-        const description = stringField(data, 'description');
-        if (!skillName || !description) {
-            this.ctx.logger.warn(`[superpowers] get ${candidate.name}: frontmatter requires name and description`);
-            return undefined;
-        }
-        if (skillName !== candidate.name) {
-            // 名称漂移视为失效，触发上层 invalidate
-            this.ctx.logger.warn(`[superpowers] get ${candidate.name}: name drift "${skillName}" != "${candidate.name}"`);
-            return undefined;
-        }
-        let invocation;
-        try {
-            invocation = parseInvocationPolicy(data);
-        }
-        catch (e) {
-            this.ctx.logger.warn(`[superpowers] get ${candidate.name}: ${String(e)}`);
-            return undefined;
-        }
-        return {
-            name: skillName,
-            description,
-            ...optionalString(data, 'whenToUse'),
-            invocation,
-            source: 'bundled',
-            provider: this.name,
-            resourceBase: { kind: 'directory', path: locator.directory },
-            path: locator.path,
-            ...optionalMetadata(data),
-            content: parsed.body.trim(),
-        };
+        return this.catalog.getDefinition(candidate, this.name, {
+            signal: options.signal,
+            logger: this.ctx.logger,
+        });
     }
 }
-async function parseSkillFile(path) {
-    const raw = await readFile(path, 'utf8');
-    const parsed = parseFrontmatter(raw);
-    if (!parsed)
-        return undefined;
-    return parsed;
-}
 // ---------------------------------------------------------------------------
 // 插件入口 — 所有副作用走 ctx 注册，随 fiber 卸载自动清理
 // ---------------------------------------------------------------------------
@@ -309,18 +82,22 @@ export function apply(ctx, config) {
     ctx.logger.info(`[superpowers] registering provider "${config.providerName}"`);
     // 将 provider 注册与事件监听放入同一个 effect，保证卸载时的清理顺序可控
     ctx.effect(() => {
+        let activeProvider;
         const disposeProvider = ctx.skills.registerProvider((control) => {
-            return new SuperpowersProvider(ctx, control, config);
+            activeProvider = new SuperpowersProvider(ctx, control, config);
+            return activeProvider;
         });
-        // skills/change 为 emit 模式（见 @deepseek-ai/dsh-skill Events 定义：@mode emit），非 waterfall，无需 next()
+        // skills/change 为 emit 模式，感知外部变更并精准失效内存快照
         const disposeListener = ctx.on('skills/change', () => {
-            ctx.logger.debug('[superpowers] skills catalog changed');
+            ctx.logger.debug('[superpowers] skills catalog changed, invalidating snapshot');
+            activeProvider?.catalog.invalidate();
         });
         return () => {
             disposeListener();
             disposeProvider();
+            activeProvider?.catalog.invalidate();
         };
     });
 }
-export default { name, inject, Config, apply };
+export default { name, inject, Config, apply, SkillDocument, SkillCatalog };
 //# sourceMappingURL=superpowers.js.map

package/lib/superpowers.js.map

@@ -1 +1 @@
-{"version":3,"file":"superpowers.js","sourceRoot":"","sources":["../src/superpowers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"superpowers.js","sourceRoot":"","sources":["../src/superpowers.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wenaixi/dsh-superpower",
-  "version": "7.0.0",
+  "version": "7.0.1",
   "description": "obra/superpowers 的 DSH 移植版 — 将完整的多智能体开发方法论以原生 DSH 技能开箱即用",
   "type": "module",
   "main": "lib/superpowers.js",

package/skills/brainstorming/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: brainstorming
-description: "Superpower Skill（最高优先级）：创意工作前必用——创建功能、构建组件、新增能力或变更行为前，先澄清用户意图、需求与设计，再进入实现。"
+description: "Superpower Skill：创意工作前必用——创建功能、构建组件、新增能力或变更行为前，先澄清用户意图、需求与设计，再进入实现。"
 ---
 
 # 将想法头脑风暴为设计

package/skills/brainstorming/scripts/server.cjs

@@ -106,8 +106,7 @@ const SUPERPOWERS_VERSION = readSuperpowersVersion();
 const SUPERPOWERS_BRAND_IMAGE_URL = 'https://primeradiant.com/brand/superpowers-visual-brainstorming-logo.png';
 const TELEMETRY_DISABLE_ENV_VARS = [
   'SUPERPOWERS_DISABLE_TELEMETRY',
-  'DISABLE_TELEMETRY',
-  'CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC'
+  'DISABLE_TELEMETRY'
 ];
 const SUPERPOWERS_TELEMETRY_DISABLED = TELEMETRY_DISABLE_ENV_VARS.some(name => isTruthyEnv(process.env[name]));
 let ownerPid = process.env.BRAINSTORM_OWNER_PID ? Number(process.env.BRAINSTORM_OWNER_PID) : null;
@@ -207,18 +206,11 @@ const helperInjection = '<script>\n' + helperScript + '\n</script>';
 
 function readSuperpowersVersion() {
   const root = path.join(__dirname, '../../..');
-  const manifests = [
-    path.join(root, 'package.json'),
-    path.join(root, '.codex-plugin/plugin.json')
-  ];
-
-  for (const manifest of manifests) {
-    try {
-      const data = JSON.parse(fs.readFileSync(manifest, 'utf-8'));
-      if (data.version) return String(data.version);
-    } catch (e) {
-      // Packaged Codex plugins omit package.json; try the next manifest.
-    }
+  try {
+    const data = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf-8'));
+    if (data.version) return String(data.version);
+  } catch (e) {
+    // DSH bundle reads version directly from root package.json
   }
 
   return 'unknown';

package/skills/brainstorming/scripts/start-server.sh

@@ -15,7 +15,7 @@
 #   --open                Auto-open the browser on the first screen (use only
 #                         after the user approves the visual companion).
 #   --foreground          Run server in the current terminal (no backgrounding).
-#   --background          Force background mode (overrides Codex auto-foreground).
+#   --background          Force background mode.
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 
@@ -94,11 +94,6 @@ is_windows_like_shell() {
   return 1
 }
 
-# Some environments reap detached/background processes. Auto-foreground when detected.
-if [[ -n "${CODEX_CI:-}" && "$FOREGROUND" != "true" && "$FORCE_BACKGROUND" != "true" ]]; then
-  FOREGROUND="true"
-fi
-
 # Windows/Git Bash reaps nohup background processes. Auto-foreground when detected.
 if [[ "$FOREGROUND" != "true" && "$FORCE_BACKGROUND" != "true" ]]; then
   if is_windows_like_shell; then

package/skills/brainstorming/spec-document-reviewer-prompt.md

@@ -1,4 +1,4 @@
-# Spec 文档审查提示词模板
+# Spec 文档 reviewer prompt 模板
 
 在派发 Spec 文档审查 subagent 时使用本模板。
 

package/skills/brainstorming/visual-companion.md

@@ -33,8 +33,8 @@
 ## 启动会话
 
 ```bash
-# Start AFTER the user approves the companion. --open auto-opens their browser on
-# the first screen; --project-dir persists mockups and enables same-port restart.
+# 在用户批准 companion 后启动。--open 会在首屏自动打开其浏览器；
+# --project-dir 持久化原型并支持同端口重启。
 bash scripts/start-server.sh --project-dir /path/to/project --open
 
 # Returns: {"type":"server-started","port":52341,
@@ -51,40 +51,14 @@ bash scripts/start-server.sh --project-dir /path/to/project --open
 
 **注意：** 将项目根目录作为 `--project-dir` 传入，这样原型会持久化到 `.superpowers/brainstorm/` 并在服务器重启后依然保留。若不传，文件会写入 `/tmp` 并被清理。如果 `.gitignore` 中尚未包含 `.superpowers/`，请提醒用户添加。
 
-**按平台启动服务器：**
+**在 DSH 中启动服务器：**
 
-**Claude Code：**
 ```bash
-# Default mode works — the script backgrounds the server itself.
-bash scripts/start-server.sh --project-dir /path/to/project --open
-```
-
-在 Windows 上，脚本会自动检测并切换到前台模式（会阻塞工具调用）。请在 Bash 工具调用上使用 `run_in_background: true`，使服务器在对话轮次之间保持运行，然后在下一轮读取 `$STATE_DIR/server-info` 以获取 URL 和端口。
-
-**Codex：**
-```bash
-# Codex reaps background processes. The script auto-detects CODEX_CI and
-# switches to foreground mode. Run it normally — no extra flags needed.
-bash scripts/start-server.sh --project-dir /path/to/project --open
-```
-
-**Gemini CLI：**
-```bash
-# Use --foreground and set is_background: true on your shell tool call
-# so the process survives across turns
-bash scripts/start-server.sh --project-dir /path/to/project --open --foreground
-```
-
-**Copilot CLI：**
-```bash
-# Start it with Copilot CLI's non-blocking/background shell mechanism so the
-# server survives across turns. Keep --foreground so the harness, not the
-# script, owns backgrounding. The launcher is a .sh, so invoke it via bash
-# (on Windows, call Git Bash's bash.exe from the PowerShell tool).
+# 在 DSH 中使用 pwsh（Windows 首选）或 bash 工具，传入 run_in_background: true
 bash scripts/start-server.sh --project-dir /path/to/project --open --foreground
 ```
 
-**其他环境：** 服务器必须在后台持续运行并跨越对话轮次。如果你的环境会回收 detached 进程，请使用 `--foreground` 并通过平台提供的后台执行机制来启动命令。
+服务器必须在后台持续运行并跨越 turn。在 DSH 工具调用中使用 `run_in_background: true`，然后在下一轮读取 `$STATE_DIR/server-info` 以获取 URL 和端口。
 
 如果 URL 在你的浏览器中无法访问（在远程/容器化环境中很常见），请绑定非回环地址：
 

package/skills/diagnosing-superpowers/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: diagnosing-superpowers
-description: "Superpower Skill（最高优先级）：当 superpowers 会话出错、human partner 想查原因（重复工作、忽略计划、技能未触发、耗时过长、成本过高、结果不佳）或想为维护者建缺陷报告时，适用当前或历史会话。"
+description: "Superpower Skill：当 superpowers 会话出错、human partner 想查原因（重复工作、忽略计划、技能未触发、耗时过长、成本过高、结果不佳）或想为维护者建缺陷报告时，适用当前或历史会话。"
 ---
 
 # 诊断 superpowers

package/skills/diagnosing-superpowers/prompts/request-conflicts.md

@@ -5,7 +5,7 @@
 1. 列出每条人类 prompt 及其行与回合。对每条，提取其包含的指令（祈使句、约束、"don't"、"always"、"never"、"only"、范围陈述）。
 2. 报告：
    - 两条无法同时遵守的人类指令（两处都引用并附行），以及助手做了什么；
-   - 与会话中加载的指令文件（CLAUDE.md、AGENTS.md、GEMINI.md 或 harness 等价物；路径在 case 文件中）冲突的人类指令，两处都引用；
+   - 与会话中加载的指令文件（AGENTS.md、CLAUDE.md 等；路径在 case 文件中）冲突的人类指令，两处都引用；
    - 人类指令要求跳过、忽略或覆盖某步骤、技能或规则，以及之后发生了什么；
    - 助手请求澄清的指令及回答（当回答改变了范围时）。
 3. 不要评判你的 human partner 是否正确。报告冲突与助手的解决方式。

package/skills/diagnosing-superpowers/templates/issue.md

@@ -7,7 +7,7 @@
 | 字段 | 值 | 来源 / 支撑证据 |
 |-------|-------|-------------------------------|
 | superpowers 版本 | <version>（<sha 或 "not a checkout">） | <历史证据 / 未验证快照 / 当前观察 / 未知>；<位置> |
-| harness（Claude Code、Cursor 等） | <harness> | <标签>；<位置> |
+| harness (DSH) | <harness> | <标签>；<位置> |
 | harness 版本 | <version> | <标签>；<位置> |
 | 你的模型 + 版本 | <所见 model ids> | <标签>；<位置> |
 | 已安装的全部插件 | <列表> | <标签>；<位置> |

package/skills/dispatching-parallel-agents/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: dispatching-parallel-agents
-description: "Superpower Skill（最高优先级）：面向 2 个以上无共享状态、无前后依赖的独立任务，并行委派多个 subagent 协同处理的高效分发模式。"
+description: "Superpower Skill：面向 2 个以上无共享状态、无前后依赖的独立任务，并行委派多个 subagent 协同处理的高效分发模式。"
 ---
 
 # 并行分发 agent
@@ -71,7 +71,7 @@ digraph when_to_use {
 Subagent (general-purpose): "Fix agent-tool-abort.test.ts failures"
 Subagent (general-purpose): "Fix batch-completion-behavior.test.ts failures"
 Subagent (general-purpose): "Fix tool-approval-race-conditions.test.ts failures"
-# All three run concurrently.
+# 全部三个并发执行。
 ```
 
 在同一条回复中发起多次分发调用 = 并行执行。每条回复只发一次 = 串行执行。
@@ -84,9 +84,9 @@ Subagent (general-purpose): "Fix tool-approval-race-conditions.test.ts failures"
 - 运行完整测试套件
 - 整合所有变更
 
-## agent 提示词结构
+## agent prompt 结构
 
-优秀的 agent 提示词应具备：
+优秀的 agent prompt应具备：
 1. **聚焦** - 一个清晰的问题域
 2. **自包含** - 包含理解问题所需的全部上下文
 3. **输出明确** - agent 应该返回什么？

package/skills/executing-plans/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: executing-plans
-description: "Superpower Skill（最高优先级）：当你在本会话中亲自作为实现者执行实施计划时使用——human partner 选择了内联执行，或环境不提供 subagent 工具。"
+description: "Superpower Skill：当你在本会话中亲自作为实现者执行实施计划时使用——human partner 选择了内联执行，或环境不提供 subagent 工具。"
 ---
 
 # 执行计划
@@ -79,7 +79,7 @@ digraph process {
 
 workspace 与 ledger 与 subagent-driven-development 共用——同一个目录、同一种格式——所以一份计划可以在执行中途换执行者，新执行者从同一份 ledger 接着往下做。
 
-- 每份计划拥有一个 workspace：技能开始时运行 `../subagent-driven-development/scripts/sdd-workspace PLAN_FILE`——它会打印本计划的 git 忽略目录（`<repo-root>/.superpowers/sdd/<plan-basename>/`），该目录是这份计划所有产物的家：ledger、brief、review package。别的计划的目录永远不归你读写。
+- 每份计划拥有一个 workspace：技能开始时运行 `bash ../subagent-driven-development/scripts/sdd-workspace PLAN_FILE`——它会打印本计划的 git 忽略目录（`<repo-root>/.superpowers/sdd/<plan-basename>/`），该目录是这份计划所有产物的家：ledger、brief、review package。别的计划的目录永远不归你读写。
 - 在本计划的 `<workspace>/progress.md` 检查 ledger。如果它的第一行点名的是你的计划文件，那么带 `Task <N>: complete` 行的任务就是已完成的——不要重做；从第一个没有该行的任务继续。即使你的上下文已不记得做过，它们的提交也确实存在于 git 中：压缩之后，宁可相信 ledger 与 `git log`，也不要相信自己的回忆。第一行点名了另一份计划文件的 ledger，是别的计划的进度：别动它，另起一份全新的。
 - 创建 ledger，第一行写身份：`# SDD ledger — plan: <plan file path>`。
 - `git clean -fdx` 会摧毁 workspace（它是 git 忽略的临时区）；真要发生，从 `git log` 恢复。
@@ -96,7 +96,7 @@ workspace 与 ledger 与 subagent-driven-development 共用——同一个目录
 
 ### 1. 接手任务
 
-- 运行本技能的 `scripts/task-start PLAN_FILE N`。它在一次调用中打印 brief 路径与 BASE（该任务评审区间的起点提交）。每个任务都要读 brief，包括你在准备阶段记得的那些：你记得的是摘要，brief 里才是精确的取值、签名与测试用例。
+- 运行本技能的 `bash scripts/task-start PLAN_FILE N`。它在一次调用中打印 brief 路径与 BASE（该任务评审区间的起点提交）。每个任务都要读 brief，包括你在准备阶段记得的那些：你记得的是摘要，brief 里才是精确的取值、签名与测试用例。
 - 把该任务的 todo 标为 in_progress。
 
 每一次工具调用都是一轮重新读取你全部上下文的过程。记账要搭着干活一起走——追加 ledger 与提交放在同一次调用里，绝不单独花一次调用。
@@ -126,7 +126,7 @@ workspace 与 ledger 与 subagent-driven-development 共用——同一个目录
 
 ### 4. 完成任务
 
-运行本技能的 `scripts/task-done PLAN_FILE N BASE -- <测试命令>`，测试命令用 brief 为整个任务点名的那条。它会运行测试，把完整输出留在 workspace，打印尾部，并且——只在测试通过时——把完成行追加到 ledger：
+运行本技能的 `bash scripts/task-done PLAN_FILE N BASE -- <测试命令>`，测试命令用 brief 为整个任务点名的那条。它会运行测试，把完整输出留在 workspace，打印尾部，并且——只在测试通过时——把完成行追加到 ledger：
 
 `Task <N>: complete (commits <base7>..<head7>, tests: <command> → <result>)`
 
@@ -134,7 +134,7 @@ workspace 与 ledger 与 subagent-driven-development 共用——同一个目录
 
 ## 最终评审
 
-运行 `../subagent-driven-development/scripts/review-package PLAN_FILE MERGE_BASE HEAD`（MERGE_BASE = 分支起点的提交，例如 `git merge-base main HEAD`），并从它打印出的文件出发评审。
+运行 `bash ../subagent-driven-development/scripts/review-package PLAN_FILE MERGE_BASE HEAD`（MERGE_BASE = 分支起点的提交，例如 `git merge-base main HEAD`），并从它打印出的文件出发评审。
 
 **有 subagent 工具时：** 用可用的最强模型派发 reviewer——全分支评审是一项判断题——使用 requesting-code-review 的 [code-reviewer.md](../requesting-code-review/code-reviewer.md)，并把包路径、计划与规格路径、计划的 Review Focus 段（若存在）逐字交给它（该段列出计划的测试未覆盖的输入类别与失败模式——reviewer 要逐条刻意检查），再加一个指向 ledger 中 `Ruling:` 行的提示，让它能权衡你所做的决定。明确指定模型；省略模型会继承本会话的模型，而它未必是最强的。这是整轮执行唯一买到的一份全新上下文。不要跳过它，也不要用你自己读 diff 来代替它。
 

package/skills/finishing-a-development-branch/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: finishing-a-development-branch
-description: "Superpower Skill（最高优先级）：实现完成且全部测试通过后，用于决定分支集成方式，支持本地合并、创建 PR 或保留分支等完整收尾流程。"
+description: "Superpower Skill：实现完成且全部测试通过后，用于决定分支集成方式，支持本地合并、创建 PR 或保留分支等完整收尾流程。"
 ---
 
 # 完成开发分支
@@ -30,8 +30,8 @@ description: "Superpower Skill（最高优先级）：实现完成且全部测
 ```bash
 GIT_DIR=$(cd "$(git rev-parse --git-dir)" 2>/dev/null && pwd -P)
 GIT_COMMON=$(cd "$(git rev-parse --git-common-dir)" 2>/dev/null && pwd -P)
-# Capture now, while still inside the workspace — Step 5 changes directory
-# before cleanup (Step 6) needs this value
+# 此时仍在工作区内，立即捕获此值——步骤 5 会切换目录，
+# 而后清理阶段（步骤 6）需要该值
 WORKTREE_PATH=$(git rev-parse --show-toplevel)
 ```
 
@@ -45,7 +45,7 @@ WORKTREE_PATH=$(git rev-parse --show-toplevel)
 
 ## 步骤 3：确定基线分支
 
-基线分支即本次工作分叉时的来源分支——通常在计划、对话记录或分支的上游中已注明。若尚未明确，请询问：“该分支是从 <你的最佳推测> 分叉出来的，这样对吗？” 合并前务必确认：合错基线分支的回滚成本很高。
+基线分支即本次工作 fork 时的来源分支——通常在计划、对话记录或分支的上游中已注明。若尚未明确，请询问：“该分支是从 <你的最佳推测> fork 出来的，这样对吗？” 合并前务必确认：合错基线分支的回滚成本很高。
 
 ## 步骤 4：提供选项
 
@@ -198,5 +198,5 @@ worktree 移除被拒绝——以下文件尚未提交：
 | “这个 worktree 看起来废弃了——顺手一起清理” | 仅清理位于 `.worktrees/` 或 `worktrees/` 下的 worktree，其余均归宿主环境所有。 |
 | “移除被拒——用 `--force` 收个尾就行” | 拒绝意味着文件仅存在于该 worktree，`--force` 会永久销毁它们，请向 human partner 展示并征询意见。 |
 | “合并后失败大概是偶发问题” | 合并结果失败则立即中止，保留分支与 worktree 以便排查。 |
-| “基线分支显然是 main” | 请确认分叉点或主动询问，合错基线的回滚成本很高。 |
+| “基线分支显然是 main” | 请确认fork 点或主动询问，合错基线的回滚成本很高。 |
 | “推送被拒——强制推送就能解决” | 推送被拒说明远端已有更新，请先排查；仅在 human partner 明确要求时才执行强制推送。 |