Superpowers-clurdra

一个用于 VS Code 的 obra/superpowers 文档浏览与执行插件，聚焦 docs/superpowers/ 目录下的 spec 和 plan 文件。

功能

• 在活动栏提供 Superpowers 入口，打开专用面板
• 自动扫描 docs/superpowers/specs 和 docs/superpowers/plans
• 用表格展示 spec、plan、日期、进度与状态
• 支持刷新、预览打开、删除关联 spec/plan 文件
• 支持在面板里直接运行 plan
• 运行 plan 前自动创建独立 git worktree，隔离实现过程
• 支持把 plan 状态标记为进行中、需要测试、已完成

适用目录结构

docs/
  superpowers/
    specs/
    plans/

插件会读取 Markdown 文件的第一个 H1 作为标题，并从文件名中提取日期。

Plan 运行方式

运行 plan 时，插件会：

1. 根据 plan 文件名生成 feature/... 分支名
2. 按配置创建 git worktree
3. 用 systemd-run --user 在 worktree 目录后台执行 opencode run

默认执行命令等价于：

systemd-run --user --unit=opencode-plan-xxx --working-directory '/path/to/worktree' zsh -c 'opencode run '\''实施 docs/superpowers/plans/xxx.md'\'' --model '\''alibaba-coding-plan-cn/glm-5'\'' --agent '\''build'\''' 

配置项

插件提供这些 VS Code 配置：

• superpowers.runMessage: 运行 plan 时传给 opencode run 的消息模板，支持 $plan_relative_path
• superpowers.runModel: 运行 plan 时使用的模型
• superpowers.runAgent: 运行 plan 时使用的 agent
• superpowers.worktreeDirectory: worktree 目录模板，支持 $project_root、$project_name、$feature_name

默认值：

{
  "superpowers.runMessage": "实施 $plan_relative_path",
  "superpowers.runModel": "alibaba-coding-plan-cn/glm-5",
  "superpowers.runAgent": "build",
  "superpowers.worktreeDirectory": "$project_root.worktrees/$feature_name"
}

开发

安装依赖：

pnpm install

常用命令：

pnpm build
pnpm dev
pnpm test
pnpm lint
pnpm typecheck

打包扩展：

pnpm ext:package

技术栈

• TypeScript
• VS Code Extension API
• reactive-vscode
• Vitest

许可证

MIT