@kafka0102/onespec 0.1.2 → 0.2.2

package/src/setup.js

@@ -0,0 +1,211 @@
+import { execFileSync } from 'node:child_process';
+import { access } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+
+import { initProject, SUPPORTED_LANGUAGES } from './init.js';
+import { getGlobalSkillDir, getPlatform, getProjectSkillDir, PLATFORMS } from './platforms.js';
+
+const OPEN_SPEC_CLI_PACKAGE = '@fission-ai/openspec@latest';
+const SUPERPOWERS_PACKAGE = 'obra/superpowers';
+
+export const SUPPORTED_PLATFORM_IDS = Object.keys(PLATFORMS);
+
+async function exists(filePath) {
+  try {
+    await access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function commandExists(command) {
+  try {
+    const checker = process.platform === 'win32' ? 'where' : 'which';
+    execFileSync(checker, [command], { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function getNpxExecutable(platform = process.platform) {
+  return platform === 'win32' ? 'npx.cmd' : 'npx';
+}
+
+export function getNpmExecutable(platform = process.platform) {
+  return platform === 'win32' ? 'npm.cmd' : 'npm';
+}
+
+export function parsePlatformList(values) {
+  const rawValues = Array.isArray(values) ? values : values ? [values] : [];
+  const selected = [];
+
+  for (const rawValue of rawValues) {
+    for (const part of String(rawValue).split(',')) {
+      const token = part.trim();
+      if (!token) {
+        continue;
+      }
+      selected.push(getPlatform(token).id);
+    }
+  }
+
+  return [...new Set(selected)];
+}
+
+export async function detectPlatforms(projectPath) {
+  const resolvedProject = path.resolve(projectPath);
+  const detected = [];
+
+  for (const platformId of SUPPORTED_PLATFORM_IDS) {
+    const projectSkillDir = getProjectSkillDir(resolvedProject, platformId);
+    const globalSkillDir = getGlobalSkillDir(platformId);
+    if ((await exists(projectSkillDir)) || (await exists(globalSkillDir))) {
+      detected.push(platformId);
+    }
+  }
+
+  return detected;
+}
+
+export async function detectExistingOneSpecPlatforms(projectPath, scope, platformIds) {
+  const resolvedProject = path.resolve(projectPath);
+  const existing = [];
+
+  for (const platformId of platformIds) {
+    const skillDir =
+      scope === 'global'
+        ? getGlobalSkillDir(platformId)
+        : getProjectSkillDir(resolvedProject, platformId);
+    if (await exists(path.join(skillDir, 'onespec', 'SKILL.md'))) {
+      existing.push(platformId);
+    }
+  }
+
+  return existing;
+}
+
+export function buildOpenSpecCliInstallCommand() {
+  return {
+    command: getNpmExecutable(),
+    args: ['install', '-g', OPEN_SPEC_CLI_PACKAGE],
+  };
+}
+
+export function buildOpenSpecInitCommand(targetPath, platformIds, scope, homeDir = os.homedir()) {
+  const resolvedPlatforms = parsePlatformList(platformIds);
+  if (resolvedPlatforms.length === 0) {
+    throw new Error('At least one platform must be selected.');
+  }
+
+  const openSpecToolIds = resolvedPlatforms.map((platformId) => getPlatform(platformId).openspecToolId);
+  return {
+    command: 'openspec',
+    args: ['init', scope === 'global' ? homeDir : targetPath, '--tools', openSpecToolIds.join(',')],
+    toolIds: openSpecToolIds,
+    targetPath: scope === 'global' ? homeDir : targetPath,
+  };
+}
+
+export function buildSuperpowersInstallCommand(platformIds, scope) {
+  const resolvedPlatforms = parsePlatformList(platformIds);
+  if (resolvedPlatforms.length === 0) {
+    throw new Error('At least one platform must be selected.');
+  }
+
+  const args = ['skills', 'add', SUPERPOWERS_PACKAGE, '-y'];
+  if (scope === 'global') {
+    args.push('-g');
+  }
+  for (const platformId of resolvedPlatforms) {
+    args.push('--agent', getPlatform(platformId).id);
+  }
+
+  return {
+    command: getNpxExecutable(),
+    args,
+    agents: resolvedPlatforms,
+  };
+}
+
+function runCommand(command, args, cwd = process.cwd()) {
+  execFileSync(command, args, {
+    cwd,
+    stdio: 'inherit',
+    shell: process.platform === 'win32',
+  });
+}
+
+export async function initWorkspace(targetPath, options = {}, dependencies = {}) {
+  const projectPath = path.resolve(targetPath);
+  const scope = options.scope ?? 'project';
+  const language = options.language ?? 'zh';
+  const platformIds = parsePlatformList(options.platforms ?? []);
+  const selectedPlatformIds = platformIds.length > 0 ? platformIds : ['codex'];
+
+  if (!['project', 'global'].includes(scope)) {
+    throw new Error(`Unsupported scope "${scope}". Use "project" or "global".`);
+  }
+  if (!SUPPORTED_LANGUAGES[language]) {
+    throw new Error(
+      `Unsupported language "${language}". Use one of: ${Object.keys(SUPPORTED_LANGUAGES).join(', ')}.`,
+    );
+  }
+
+  const commandChecker = dependencies.commandExists ?? commandExists;
+  const commandRunner = dependencies.runCommand ?? runCommand;
+  const projectInitializer = dependencies.initProject ?? initProject;
+  const homeDir = dependencies.homeDir ?? os.homedir();
+
+  let openspecCliStatus = 'present';
+  if (!commandChecker('openspec')) {
+    const cliInstall = buildOpenSpecCliInstallCommand();
+    commandRunner(cliInstall.command, cliInstall.args, projectPath);
+    openspecCliStatus = 'installed';
+    if (!commandChecker('openspec')) {
+      throw new Error(`OpenSpec CLI installation completed but \`openspec\` is still unavailable.`);
+    }
+  }
+
+  const openSpecSetup = buildOpenSpecInitCommand(projectPath, selectedPlatformIds, scope, homeDir);
+  commandRunner(openSpecSetup.command, openSpecSetup.args, projectPath);
+
+  const superpowersSetup = buildSuperpowersInstallCommand(selectedPlatformIds, scope);
+  commandRunner(superpowersSetup.command, superpowersSetup.args, projectPath);
+
+  const results = [];
+  for (const platformId of selectedPlatformIds) {
+    results.push(
+      await projectInitializer(projectPath, {
+        ...options,
+        platform: platformId,
+        scope,
+        language,
+      }),
+    );
+  }
+
+  return {
+    projectPath,
+    scope,
+    language,
+    languageName: SUPPORTED_LANGUAGES[language].name,
+    platforms: selectedPlatformIds,
+    platformNames: selectedPlatformIds.map((platformId) => getPlatform(platformId).name),
+    openspecCli: {
+      status: openspecCliStatus,
+      package: OPEN_SPEC_CLI_PACKAGE,
+    },
+    openspec: {
+      targetPath: openSpecSetup.targetPath,
+      toolIds: openSpecSetup.toolIds,
+    },
+    superpowers: {
+      package: SUPERPOWERS_PACKAGE,
+      agents: superpowersSetup.agents,
+    },
+    results,
+  };
+}

package/assets/skills/onespec-archive/SKILL.md

@@ -1,202 +0,0 @@
----
-name: onespec-archive
-description: 当用户需要对 OneSpec change 做最终评审、处理反馈、删除 worktree 或执行 OpenSpec archive 时使用。
----
-
-# OneSpec Archive
-
-用于 OneSpec 的评审、收尾与归档阶段。目标是在用户确认后执行删除 worktree 与 OpenSpec archive，不默认执行有后果的操作。
-
-开始时说明：
-
-> 我正在使用 `onespec-archive` 处理 review / closeout 阶段。
-
-## 1. 评审入口
-
-先恢复状态：
-
-```bash
-ONESPEC_ENV="${ONESPEC_ENV:-$(find . "$HOME"/.codex "$HOME"/.agents "$HOME"/.config -path '*/onespec/scripts/onespec-env.sh' -type f -print -quit 2>/dev/null)}"
-. "$ONESPEC_ENV"
-"$ONESPEC_BASH" "$ONESPEC_STATE" list
-```
-
-如果发现相关 change，必须继续执行：
-
-```bash
-"$ONESPEC_BASH" "$ONESPEC_STATE" recover <change-id>
-```
-
-`recover` 的输出是当前阶段合同，不是参考信息。至少先读取 `phase`、`next_skill`、`next_gate` 与 `allowed_actions`，再决定是否继续收尾阶段动作。
-
-读取最少必要上下文：
-
-- `openspec/changes/<change-id>/proposal.md`
-- `openspec/changes/<change-id>/tasks.md`
-- `openspec/changes/<change-id>/design.md`，如果存在
-- 相关 `openspec/specs/**`
-- 最新测试结果与 `openspec validate <change-id> --strict` 结果
-- 当前分支、worktree 和工作区状态
-- `origin_branch`、`origin_workspace_path`、`origin_workspace_mode`
-
-如果状态尚未到 `review`，先说明缺少什么：未实现、未验证、未回填 `tasks.md`，或 proposal 尚未批准。
-
-入口校验：如果 phase 已到 `review`，但 `.onespec.yaml` 里的 `handoff_purpose` 不是 `review`，或 `handoff_hash` 为空，说明 execute gate 可能未正常完成。此时必须告诉用户："执行阶段的 review handoff 状态未写回，建议先回到执行阶段补充汇报（回复 `补充汇报` 或重新触发 execute gate）。" 不允许静默跳过。
-
-## 2. 用户评审
-
-实现完成后让用户评审。若用户指出问题，继续修改并重新验证。
-
-开发完成后不需要再次让用户确认是否 review，也不需要展示常规“继续评审 / 保留分支”类选项。只需询问是否进行归档；如果用户回复任意非编号内容，默认视为“继续修改当前实现”，直接回到代码处理环节。
-
-不要让用户自己猜“下一步该输入什么”。进入 `onespec-archive` 时，必须给出可直接回复的编号选项；如果支持多动作组合，允许用户回复逗号分隔的数字，例如 `1,3`。
-
-进入收尾选择前，必须显式向用户汇报：
-
-- 当前分支名
-- 当前工作区路径
-- 最初开始这次 change 时记录的 `origin_branch` 与 `origin_workspace_path`
-- 当前是否仍在原始分支/原始工作区
-
-如果当前分支或工作区不同于 `origin_*`，必须明确说明“你当前看到的是临时实现分支或临时 worktree”。此时默认展示删除 worktree / 归档组合选项；如果用户改为输入任意非编号内容，则表示当前功能还有问题，需要继续修改。
-
-可选收尾路径只围绕两件事展开：
-
-- 删除 worktree
-- 执行归档
-
-不要默认自动删除 worktree。删除与归档都是有后果的操作，必须来自用户选择。
-
-## 2.1 Superpowers Worktree 优先规则
-
-如果 `origin_workspace_mode=worktree`，或当前路径是实现期新建的临时 worktree，收尾时必须把“回收到原始分支/工作区”的动作提到最前面说明。
-
-必须显式告诉用户：
-
-- 当前实现位于临时 worktree
-- 原始分支是 `origin_branch`
-- 原始工作区是 `origin_workspace_path`
-- 收尾后是否会删除本地临时 branch 与 worktree
-
-默认推荐顺序：
-
-1. 先在临时 worktree 完成 review。
-2. 如果无需继续修改，优先给出“删除 worktree 并归档”作为推荐收尾组合。
-3. 如果用户只想清理本地环境，则允许“仅删除 worktree”。
-4. 如果代码已经真正位于目标分支，则允许“仅归档”。
-
-## 2.2 多选收尾组合
-
-收尾选项不要再只做单选。动作本身就应围绕组合展开；组合输入使用编号列表，例如 `1,3`：
-
-- `删除 worktree`
-- `执行归档`
-
-推荐的组合校验逻辑：
-
-- `{删除 worktree 并归档}`：等价于 `{删除 worktree, 执行归档}`。
-- `{删除 worktree, 执行归档}`：合法。适用于临时 worktree 已完成使命，需要直接清理并归档。
-- `{仅删除 worktree}`：等价于 `{删除 worktree}`。
-- `{删除 worktree}`：合法。适用于只清理本地临时 worktree，稍后再归档。
-- `{仅归档}`：等价于 `{执行归档}`。
-- `{执行归档}`：仅当代码已经位于目标分支时合法；如果当前还在临时 branch / worktree，默认不合法。
-
-如果用户勾选了非法组合，必须明确指出冲突原因，不要替用户猜测执行顺序。
-
-默认推荐组合：
-
-- 当前在 Superpowers 临时 worktree：推荐 `{删除 worktree, 执行归档}`。
-- 当前在临时 worktree，但用户只想先清理本地环境：推荐 `{删除 worktree}`。
-- 当前不在临时 worktree，且代码已真正位于目标分支：推荐 `{执行归档}`。
-
-推荐向用户展示的收尾选项至少包含：
-
-1. 删除 worktree 并归档
-2. 仅删除 worktree
-3. 仅归档
-其他：如果意图不在以上选项里，允许用户直接补充说明；任意非编号内容视为继续修改当前实现
-
-菜单解释规则：
-
-- 用户回复 `1`：执行“删除 worktree 并归档”。
-- 用户回复 `2`：仅删除 worktree。
-- 用户回复 `3`：仅当代码已合并且归档前置条件满足时，执行 archive；否则先说明阻塞条件。
-- 用户回复多项编号，如 `1,3`：按组合规则校验。合法时按安全执行顺序运行；不合法时明确指出冲突原因。
-- 用户输入数字外的自由文本：默认视为继续修改当前实现，直接回到代码处理环节；只有意图不清晰时才补一个最短澄清问题。
-
-## 3. 归档规则
-
-进入 archive 或删除 worktree 的最终收尾前，必须检查当前是否仍有“与本次 change 相关的未提交代码”：
-
-```bash
-"$ONESPEC_BASH" "$ONESPEC_COMMIT" related-dirty <change-id>
-```
-
-- 如果结果为空，继续后续收尾。
-- 如果结果为空，即使工作区里还有无关未跟踪目录，也不要阻塞收尾；例如未记录到 `.onespec.yaml` tracked file 列表里的 `.superpowers/` 可以明确说明“未纳入本次提交”，但不应视为本次 change 的阻塞项。
-- 如果结果非空，先向用户明确提示这些文件尚未提交，并暂停归档。
-- 若用户要求现在提交，只能 stage 本次 change 相关文件：
-
-```bash
-"$ONESPEC_BASH" "$ONESPEC_COMMIT" stage-related <change-id>
-```
-
-- 提交信息优先遵循项目自身指定的 Git 提交策略。先探测项目内文档和配置：
-
-```bash
-"$ONESPEC_BASH" "$ONESPEC_COMMIT" detect-policy <change-id>
-```
-
-- 如果项目里存在明确规范，按项目要求处理 commit message 的格式、scope 和语言。
-- 如果项目里没有明确规范，回退到通用 Conventional Commits：`<type>(<scope>): <简要描述>`。
-- 只能提交 `.onespec.yaml` 中记录的 tracked files 与当前脏文件的交集；如果 `.onespec.yaml` 本身是脏的，也应一并提交，不允许把无关改动一并提交。
-- 例外：位于 `openspec/changes/<change-id>/` 下、专属于本次 change 的临时压缩包、导出包或交接工件，也视为本次 change 相关文件；自动提交时要一并带上，这样 archive 后仍能保留在 change 历史里。
-- 如果代码已合并到目标分支且用户选择归档，直接执行 OpenSpec archive，并将状态设为 `archived`。
-- 如果用户当前只删除 worktree、不归档，将状态设为 `done`，并提示之后可再运行归档；此时不要删除 `.onespec.yaml`。
-- 只有真正执行 archive 后，才删除运行时状态文件：
-
-```bash
-"$ONESPEC_BASH" "$ONESPEC_CLOSEOUT" cleanup-runtime <change-id>
-```
-
-用户一旦通过收尾菜单明确选择了归档或组合归档动作，就把这次选择视为唯一确认；不要再追加第二次确认。
-
-实际执行收尾动作时，优先使用：
-
-```bash
-"$ONESPEC_BASH" "$ONESPEC_CLOSEOUT" run-actions <change-id> [delete-worktree] [archive]
-```
-
-```bash
-"$ONESPEC_BASH" "$ONESPEC_STATE" set <change-id> phase done
-"$ONESPEC_BASH" "$ONESPEC_STATE" set <change-id> archive <skipped|archived>
-```
-
-归档前必须确认：
-
-- `tasks.md` 已按实际完成项勾选
-- 项目测试已通过，或未通过项已明确说明
-- `openspec validate <change-id> --strict` 已通过
-- 用户明确选择了删除 worktree、归档或它们的组合策略
-- 没有未处理的用户评审反馈
-
-## 4. 汇报
-
-收尾汇报必须覆盖：
-
-- 用户评审结果
-- 选择的收尾路径：删除 worktree、归档或组合执行
-- 分支/worktree 的最终状态
-- 当前分支与 `origin_branch` 的关系，以及是否仍保留临时 worktree
-- `tasks.md`、测试与 OpenSpec validate 状态
-- archive 字段：`skipped` 或 `archived`
-
-## 5. 停止条件
-
-以下情况必须暂停并向用户说明：
-
-- 用户还没有完成最终评审
-- 用户没有明确选择收尾路径
-- 用户没有明确确认删除 worktree 或 OpenSpec archive
-- 代码未合并到目标分支且也未选择允许的删除 worktree 组合时，却要求单独 archive
-- 测试或 `openspec validate <change-id> --strict` 未通过且用户未明确接受风险

package/assets/skills/onespec-execute/SKILL.md

@@ -1,219 +0,0 @@
----
-name: onespec-execute
-description: 当用户需要执行已批准 OpenSpec change、继续实现、生成 Superpowers plan、运行 OpenSpec apply、回填 tasks 或验证实现时使用。
----
-
-# OneSpec Execute
-
-用于 OneSpec 的执行阶段。目标是只在已批准范围内实现，并把实现结果回填 OpenSpec 状态。
-
-开始时说明：
-
-> 我正在使用 `onespec-execute` 处理 apply / implement 阶段。
-
-## 1. Apply 路由
-
-先恢复状态：
-
-```bash
-ONESPEC_ENV="${ONESPEC_ENV:-$(find . "$HOME"/.codex "$HOME"/.agents "$HOME"/.config -path '*/onespec/scripts/onespec-env.sh' -type f -print -quit 2>/dev/null)}"
-. "$ONESPEC_ENV"
-"$ONESPEC_BASH" "$ONESPEC_STATE" list
-```
-
-如果发现相关 change，必须继续执行：
-
-```bash
-"$ONESPEC_BASH" "$ONESPEC_STATE" recover <change-id>
-```
-
-`recover` 的输出是当前阶段合同，不是参考信息。至少先读取 `phase`、`next_skill`、`next_gate` 与 `allowed_actions`，再决定是否继续执行阶段动作。
-
-apply 前至少读取：
-
-- `openspec/changes/<change-id>/proposal.md`
-- `openspec/changes/<change-id>/tasks.md`
-- `openspec/changes/<change-id>/design.md`，如果存在
-- 相关 `openspec/specs/**`
-- 相关 `docs/**`
-
-默认意图映射：
-
-- 用户说“开始实现”、“执行这个 change”、“apply 这个 proposal / change”、“继续做这个 change”、“开始 coding / 开发”、“make plan”时，默认解释为进入已批准 change 的 Superpowers 实现准备路径，而不是直接原生 `openspec apply`。
-- 只有用户明确说“不用 Superpowers plan”、“不用 subagent”或“直接按 OpenSpec apply”时，才允许走原生 OpenSpec apply。
-- 如果 proposal 阶段已经确认过实现路线，后续 apply 优先遵循该确认结果，不要用默认映射覆盖用户已确认的路线。
-
-如果 proposal 尚未批准，直接停止，不要开始实现。
-
-如果 proposal 阶段已经确认实现路径：
-
-- 用户确认 `Superpowers`：继续 Superpowers Make Plan。
-- 用户确认原生 `OpenSpec apply`：切换到原生 OpenSpec apply。
-- 用户尚未确认：提醒当前推荐路线，并用编号菜单要求用户选择，不要直接开始实现。
-
-如果必须在执行阶段补做路线确认，使用下面的编号菜单，用户回复数字即可：
-
-1. 按推荐路线继续
-2. 改成 `Superpowers`
-3. 改成原生 `OpenSpec apply`
-4. 先不要开始实现，我要先回去修改 proposal / design / tasks
-其他：如果意图不在以上选项里，允许用户直接补充说明
-
-菜单解释规则：
-
-- 用户回复 `1`：采用当前推荐路线。
-- 用户回复 `2`：切换到 `Superpowers`，并继续用编号菜单确认 `subagent/local` 与 `worktree/current-branch`。
-- 用户回复 `3`：切换到原生 `OpenSpec apply`。
-- 用户回复 `4`：停止执行，返回设计修订路径。
-- 用户输入数字外的自由文本：如果意图清晰，按用户自定义意图处理；若不清晰，只补一个最短澄清问题。
-
-## 2. Superpowers Make Plan 与实现
-
-在 Superpowers 路径下，apply 默认不是“直接实现”，而是先把已批准的 OpenSpec change 翻译成 Superpowers 可执行计划。
-
-必须执行：
-
-- 读取并总结 `proposal.md`、`design.md`、`tasks.md`、相关 spec delta 与相关项目文档。
-- 从 `tasks.md` 中提取未完成 task，作为 planning scope。
-- 使用 `writing-plans` 或 `superpowers:writing-plans` 生成计划，保存到 `docs/superpowers/plans/YYYY-MM-DD-<change-id>.md`。
-- 计划必须覆盖每个未完成 OpenSpec task，可拆细，但不得遗漏或扩大范围。
-- 如果已有对应 plan，先检查它是否仍覆盖当前未完成 tasks；不覆盖就更新或重写。
-- 如果 plan 与 OpenSpec artifacts 冲突，先修正 OpenSpec artifacts，再重写 plan。
-- 从开始实现到进入 review 之前，为当前 change 维护 `openspec/changes/<change-id>/.onespec.yaml` 这个唯一运行时状态文件；本次直接修改的仓库相对路径写入其中的 `touched_files_b64`。优先使用：
-
-```bash
-"$ONESPEC_BASH" "$ONESPEC_COMMIT" track <change-id> <path>...
-```
-
-- 不要把用户原本就存在但不属于本次 change 的脏文件写入这个 tracked file 列表。
-- 如果在 `openspec/changes/<change-id>/` 下生成了临时压缩包、导出包或其他仅服务于本次 change 的工件，也要视为本次 change 的一部分保留到 archive；它们不要求单独写进 `touched_files_b64`，但后续自动提交必须把这些工件与 `.onespec.yaml` 一并提交。
-- 后续如果进入自动提交，`.onespec.yaml` 本身也应随当前 change 一起提交；它不是要提前删除的中间产物，而是 review / archive 前的恢复依据。
-
-记录计划并创建交接包：
-
-```bash
-"$ONESPEC_BASH" "$ONESPEC_STATE" set <change-id> plan <plan-path>
-"$ONESPEC_BASH" "$ONESPEC_STATE" set <change-id> phase plan-ready
-"$ONESPEC_BASH" "$ONESPEC_HANDOFF" <change-id> plan --write
-```
-
-在真正开始写代码、运行原生 apply 或派发子任务前，必须先把状态切到 `implementing`：
-
-```bash
-"$ONESPEC_BASH" "$ONESPEC_STATE" set <change-id> phase implementing
-```
-
-如果还停留在 `approved` 或 `plan-ready`，说明实现尚未正式开始；此时不允许把中途代码编辑误报为“继续实现”。
-
-如果 `origin_branch` 或 `origin_workspace_path` 仍是 `unknown`，则在真正创建 worktree、切换 branch 或开始实现前立即补记当前上下文：
-
-```bash
-"$ONESPEC_BASH" "$ONESPEC_STATE" set <change-id> origin_branch "$(git branch --show-current || echo detached)"
-"$ONESPEC_BASH" "$ONESPEC_STATE" set <change-id> origin_workspace_path "$(pwd -P)"
-"$ONESPEC_BASH" "$ONESPEC_STATE" set <change-id> origin_workspace_mode "$( "$ONESPEC_BASH" "$ONESPEC_STATE" get <change-id> workspace )"
-```
-
-默认执行路径：
-
-- 优先使用 `subagent-driven-development`。
-- 子 agent 按 task 执行时，强制遵守 `test-driven-development`。
-- controller 在每个任务后做规格符合性评审和代码质量评审，再进入下一个任务。
-- 如果用户明确要求不用 subagent，或任务强耦合到不适合逐 task 派发，说明原因后改用 `executing-plans`。
-- 需要隔离时使用 `using-git-worktrees`，不要手写绕过它的安全检查。
-
-实现完成后必须回填 OpenSpec artifacts：
-
-- 在 `tasks.md` 中勾选本次完成的任务。
-- 如果 Superpowers plan 将一个 OpenSpec task 拆成多步，只有对应实现、测试和必要 review 完成后，才允许回填该 OpenSpec task。
-- 如果实现改变了已批准事实，先同步更新 `design.md`、`proposal.md` 或 spec delta，再继续。
-- 不允许实现结果与已批准 OpenSpec 范围静默漂移。
-- 运行项目测试和 `openspec validate <change-id> --strict`。
-
-## 3. 原生 OpenSpec Apply
-
-只有当用户选择 `OpenSpec apply`、接受低复杂度推荐，或明确拒绝 Superpowers 时，才允许走原生 OpenSpec apply。
-
-原生 apply 执行后同样要：
-
-- 勾选 `tasks.md`
-- 如实现中暴露新的歧义或设计冲突，先暂停并修正 OpenSpec artifacts，必要时回到 brainstorming
-- 运行项目测试
-- 运行 `openspec validate <change-id> --strict`
-- 进入用户评审，并使用与 5.3 一致的数字菜单暂停等待后续动作
-- 将状态置为 `review`
-
-## 4. 停止条件
-
-以下情况必须暂停并向用户说明：
-
-- proposal 未批准但用户要求直接实现
-- Superpowers plan 与已批准 OpenSpec artifacts 发生冲突
-- `tasks.md` 尚未被翻译成可执行 Superpowers plan，但模型试图直接编码
-- 实现过程中发现会改变 scope、design 或 spec 的新需求
-- 测试或 `openspec validate <change-id> --strict` 未通过且尚未修复
-
-## 5. 实现完成 Gate（强制暂停）
-
-> ⚠️ 这是强制 gate。如果 gate 未通过，不允许输出任何总结或收尾建议，不允许进入下一阶段。
-
-完成实现与验证后，必须明确暂停，不允许直接继续做 merge、删除 worktree、归档或“顺手收尾”。这里的目标是进入用户评审 / `review-closeout` 等待态；开发完成后只需询问是否进行归档，不需要再要求用户先确认 review。
-
-### 5.1 强制脚本调用
-
-回填 artifacts 完成且测试通过后，必须执行以下两条命令：
-
-```bash
-"$ONESPEC_BASH" "$ONESPEC_STATE" set <change-id> phase review
-"$ONESPEC_BASH" "$ONESPEC_HANDOFF" <change-id> review --write
-```
-
-**如果这两条命令未执行，则 gate 未通过。** 不允许跳过这一步直接输出完成汇报。
-
-### 5.2 强制汇报 checklist
-
-执行完上述脚本后，必须向用户输出汇报。汇报 MUST 覆盖以下全部条目，缺一不可：
-
-1. 当前分支名
-2. 当前工作区路径
-3. `origin_branch` 与 `origin_workspace_path`（是否与当前一致）
-4. 使用了哪一个 Superpowers plan 文件
-5. 本次完成了哪些 OpenSpec task
-6. `tasks.md` 回填情况
-7. 是否更新了 `proposal.md`、`design.md` 或 spec delta
-8. 测试结果
-9. `openspec validate <change-id> --strict` 结果
-10. 下一步编号选项（必须给出可直接回复的数字菜单，并明确任意非编号内容视为继续修改当前实现）
-
-### 5.3 下一步编号菜单模板
-
-汇报结尾必须包含以下格式的编号提示（可微调措辞，但结构和编号语义不可省略）：
-
-```
----
-✅ 实现与验证已完成。
-
-📍 当前分支: `<branch>`
-📍 当前工作区: `<path>`
-📍 origin: `<origin_branch>` @ `<origin_workspace_path>`
-
-1. 进入 `onespec-archive`，选择删除 worktree / 归档相关操作
-2. 保持当前分支 / worktree 不变，先停在这里，稍后再继续
-其他：任意非编号内容视为继续修改当前实现；如果意图不在以上选项里，也可以直接补充说明
----
-```
-
-如果当前分支或工作区不同于 `origin_*`，还必须额外说明："当前实现位于临时分支或临时 worktree；若你直接回复非编号内容，我会按继续修改处理。"
-
-不要只停在“下一步应进入 `onespec-archive`”这种抽象提示，也不要只说“做 `review-closeout`”。必须同时给出用户可直接回复的编号选项。
-
-### 5.4 反模式（NEVER）
-
-以下行为构成 gate 违规，绝不允许：
-
-- 实现完成后直接输出"已完成"总结，而未执行 5.1 的脚本
-- 汇报中缺少当前分支/工作区信息（checklist 第 1-3 项）
-- 未给出明确的下一步编号选项
-- 将 archive / merge / worktree 删除操作混入实现完成汇报
-- 在用户未回复前自行进入 `onespec-archive` 阶段
-- 用"下一步应进入 onespec-archive"这种抽象描述替代具体编号菜单
-- 在用户完成 review 并明确要求收尾前，擅自删除临时 worktree