Migrate superpowers to Pi platform with bilingual support and tests by weiping · Pull Request #1507 · obra/superpowers

weiping · 2026-05-09T03:26:07Z

What problem are you trying to solve?

What does this PR change?

Is this change appropriate for the core library?

What alternatives did you consider?

Does this PR contain multiple unrelated changes?

Existing PRs

I have reviewed all open AND closed PRs for duplicates or prior art
Related PRs:

Environment tested

Harness (e.g. Claude Code, Cursor)	Harness version	Model	Model version/ID

New harness support (required if this PR adds a new harness)

Clean-session transcript for "Let's make a react todo list"

paste the complete transcript here

Evaluation

What was the initial prompt you (or your human partner) used to start
the session that led to this change?
How many eval sessions did you run AFTER making the change?
How did outcomes change compared to before the change?

Rigor

If this is a skills change: I used superpowers:writing-skills and
completed adversarial pressure testing (paste results below)
This change was tested adversarially, not just on the happy path
I did not modify carefully-tuned content (Red Flags table,
rationalizations, "human partner" language) without extensive evals
showing the change is an improvement

Human review

A human has reviewed the COMPLETE proposed diff before submission

Migrate obra/superpowers workflow skills to the Pi coding agent platform: - Add bilingual (zh/en) trigger words for all 14 skills - Add bootstrap extension to inject skill rules on session start - Add dispatch_agent subagent via pi --no-session --print - Add Chinese prompt templates (/brainstorm, /write-plan, /execute-plan) - Add tool mapping (TodoWrite → TODO.md, Task → sequential dispatch) - Add comprehensive test suite (176 tests) - Update README and add INSTALL.md

…add brainstorm-server to test suite

Copilot

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Ports the Superpowers skills library to the Pi platform with bilingual (EN/ZH) skill metadata, adds Pi extensions (bootstrap + subagent dispatch), and introduces a parallel OpenClaw plugin package with supporting docs and tests.

Changes:

Added Pi extensions: bootstrap injection for using-superpowers and a dispatch_agent tool backed by pi --no-session --print.
Added Vitest suite validating skills/prompts structure plus utility/unit/integration tests for the new extensions.
Updated skill frontmatter to bilingual descriptions and added Pi-specific mapping/adaptation sections; introduced an OpenClaw plugin subpackage.

Reviewed changes

Copilot reviewed 44 out of 50 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
tsconfig.json	Adds TS config for Pi extensions typecheck.
package.json	Renames/package metadata for Pi distribution; adds scripts + dev deps.
.gitignore	Ignores Pi project settings directory.
README.md	Rewrites docs for Pi port, bilingual usage, tool mapping, and install.
INSTALL.md	Adds detailed Pi install/verification documentation.
extensions/bootstrap.ts	Implements bootstrap injection on first turn per session.
extensions/bootstrap-utils.ts	Adds pure helpers for frontmatter stripping and mapping injection.
extensions/subagent.ts	Registers `dispatch_agent` tool that spawns `pi` subprocesses.
extensions/subagent-utils.ts	Adds pure helpers for role prompts, pi args, and output parsing.
tests/bootstrap.test.ts	Unit tests for bootstrap utility functions.
tests/bootstrap-integration.test.ts	Integration tests for bootstrap assembly pipeline.
tests/subagent.test.ts	Unit tests for subagent utility functions.
tests/subagent-integration.test.ts	Integration tests ensuring extension wiring + package registration.
tests/skills-validation.test.ts	Validates skill directories, frontmatter, and bilingual requirement.
tests/prompts-validation.test.ts	Validates prompt template existence/frontmatter/content.
prompts/brainstorm.md	Adds English brainstorm prompt template.
prompts/write-plan.md	Adds English write-plan prompt template.
prompts/execute-plan.md	Adds English execute-plan prompt template.
skills/brainstorming/SKILL.md	Converts description to bilingual block format.
skills/dispatching-parallel-agents/SKILL.md	Converts description to bilingual block format.
skills/executing-plans/SKILL.md	Converts description to bilingual block format.
skills/finishing-a-development-branch/SKILL.md	Converts description to bilingual block format.
skills/receiving-code-review/SKILL.md	Converts description to bilingual block format.
skills/requesting-code-review/SKILL.md	Converts description to bilingual block format.
skills/subagent-driven-development/SKILL.md	Converts description + adds Pi adaptation section.
skills/systematic-debugging/SKILL.md	Converts description to bilingual block format.
skills/test-driven-development/SKILL.md	Converts description to bilingual block format.
skills/using-git-worktrees/SKILL.md	Converts description to bilingual block format.
skills/using-superpowers/SKILL.md	Converts description + adds Pi tool mapping section.
skills/verification-before-completion/SKILL.md	Converts description to bilingual block format.
skills/writing-plans/SKILL.md	Converts description to bilingual block format.
skills/writing-skills/SKILL.md	Converts description to bilingual block format and adds Chinese triggers.
docs/plans/2026-02-27-superpowers-pi-migration-plan.md	Adds migration plan documentation.
docs/plans/2026-02-27-openclaw-plugin-design.md	Adds OpenClaw plugin design doc.
openclaw-plugin/package.json	Adds OpenClaw plugin package metadata and build steps.
openclaw-plugin/openclaw.plugin.json	Adds OpenClaw manifest for plugin discovery.
openclaw-plugin/index.ts	Implements OpenClaw plugin registering tools.
openclaw-plugin/index.d.ts	Adds OpenClaw plugin-facing type declarations.
openclaw-plugin/openclaw-sdk.d.ts	Adds minimal SDK declaration for compilation without OpenClaw installed.
openclaw-plugin/tsconfig.json	Adds TS config + path mapping for SDK types.
openclaw-plugin/scripts/copy-skills.mjs	Copies skills into plugin package at publish time.
openclaw-plugin/README.md	Adds plugin usage documentation.
openclaw-plugin/CLAUDE.md	Adds repository guidance doc for Claude Code.
openclaw-plugin/.gitignore	Ignores build and generated artifacts in subpackage.
openclaw-plugin/OpenClaw Plugin SDK Reference.md	Adds large consolidated SDK reference doc.

Comments suppressed due to low confidence (3)

tests/prompts-validation.test.ts:1

This test requires three Chinese prompt template files (头脑风暴.md / 写计划.md / 执行计划.md), but the diff only shows the English prompt files added under prompts/. Also, the final diff hunk appears to add three prompt contents without a valid file path, which would not create the required files. Add these three prompt files under prompts/ with the shown content so CI doesn't fail.
extensions/bootstrap-utils.ts:1
This mapping states Pi has no subagent support and recommends only sequential execution, but this PR also adds a dispatch_agent tool (extensions/subagent.ts) as a Task-like replacement. Update the injected mapping (and/or using-superpowers SKILL.md mapping section) to mention dispatch_agent as the preferred alternative when available, so users and the model receive consistent guidance.

/**

skills/writing-skills/SKILL.md:1

The English description repeats "work before deployment" twice (lines 4–5). Remove the duplicate to keep the frontmatter concise (and reduce chance of hitting description-length constraints in validation).

+export function buildRolePrompt(role: string | undefined): string {
+  if (!role) return "";
+  const trimmed = role.trim();
+  if (!trimmed) return "";
+  if (trimmed === "code-quality-reviewer") return CODE_QUALITY_REVIEWER_PROMPT;
+  return `You are a ${trimmed}.`;
+}


+function copyDirectoryRecursive(source, destination) {
+  if (!existsSync(source)) return;
+
+  const entries = readdirSync(source, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = join(source, entry.name);
+    const destPath = join(destination, entry.name);
+
+    // Skip excluded patterns
+    if (EXCLUDE_PATTERNS.includes(entry.name)) {
+      console.log(`  Excluding: ${entry.name}`);
+      continue;
+    }
+
+    if (entry.isDirectory()) {
+      cpSync(srcPath, destPath, { recursive: true });
+    } else {
+      cpSync(srcPath, destPath);
+    }
+  }
+}


+        const { runId } = await api.runtime.subagent.run({
+          sessionKey: agentId || "agent:main:subagent:dispatched",
+          message: prompt,
+          deliver,
+        });
+
+        // 等待完成
+        const result = await api.runtime.subagent.waitForRun({
+          runId,
+          timeoutMs,
+        });


+# pi-superpowers

-Superpowers is a complete software development methodology for your coding agents, built on top of a set of composable skills and some initial instructions that make sure your agent uses them.
+> Superpowers 工作流技能库的 Pi 平台移植版，含中文触发支持


+sources:
+  - https://docs.openclaw.ai/plugins/sdk-overview
+  - https://docs.openclaw.ai/plugins/sdk-entrypoints
+  - https://docs.openclaw.ai/plugins/sdk-runtime
+  - https://docs.openclaw.ai/plugins/sdk-setup
+  - https://docs.openclaw.ai/plugins/sdk-testing
+  - https://docs.openclaw.ai/plugins/manifest
+  - https://docs.openclaw.ai/plugins/architecture


+> 本文档整合自官方文档七个页面，涵盖 Plugin SDK 的完整参考：概述、入口点、运行时帮助器、打包与配置、测试、清单规范，以及插件架构深度解析。
+
+---
+
+## 目录
+
+1. [[#第一章：SDK 概述]]
+2. [[#第二章：入口点（Entry Points）]]
+3. [[#第三章：运行时帮助器（Runtime Helpers）]]
+4. [[#第四章：打包与配置（Setup & Config）]]
+5. [[#第五章：插件测试（Testing）]]
+6. [[#第六章：插件清单（openclaw.plugin.json）]]
+7. [[#第七章：插件架构（Architecture）]]
+
+---
+
+## 第一章：SDK 概述
+
+Plugin SDK 是插件与核心之间的**类型化契约**，定义了**从哪里导入**以及**可以注册什么**。
+
+### 导入约定
+


- README.md: keep pi-superpowers Chinese README - package.json: keep pi config + bump version to 5.1.0 - skills/using-git-worktrees/SKILL.md: keep Chinese trigger description

obra · 2026-05-13T16:16:27Z

Hi. What does this do that #1499 doesn't?

- Rename README.md → README_CN.md (Chinese version preserved as-is) - Add English README.md with full translation of README_CN.md - Add bidirectional links between README.md and README_CN.md

weiping added 6 commits April 8, 2026 22:02

openclaw plugin

41eb52a

feat: port code-reviewer agent prompt to code-quality-reviewer role; …

935bcee

…add brainstorm-server to test suite

5.0.8

5d92afc

Merge upstream/main, keeping pi-superpowers README

f313a67

Merge branch 'obra:main' into main

ca3f8ed

Copilot AI review requested due to automatic review settings May 9, 2026 03:26

Copilot AI reviewed May 9, 2026

View reviewed changes

weiping added 2 commits May 9, 2026 11:45

Merge upstream/main v5.1.0, keeping pi-superpowers customizations

90fe036

- README.md: keep pi-superpowers Chinese README - package.json: keep pi config + bump version to 5.1.0 - skills/using-git-worktrees/SKILL.md: keep Chinese trigger description

chore: register ours merge strategy for pi-superpowers customized files

98e4ffc

j7an mentioned this pull request May 9, 2026

fix(brainstorming): ground recommendations in named comparison dimensions #1512

Draft

5 tasks

docs: add English README and bilingual cross-links

abc191f

- Rename README.md → README_CN.md (Chinese version preserved as-is) - Add English README.md with full translation of README_CN.md - Add bidirectional links between README.md and README_CN.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Migrate superpowers to Pi platform with bilingual support and tests#1507

Migrate superpowers to Pi platform with bilingual support and tests#1507
weiping wants to merge 9 commits into
obra:mainfrom
weiping:main

weiping commented May 9, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

obra commented May 13, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

weiping commented May 9, 2026

What problem are you trying to solve?

What does this PR change?

Is this change appropriate for the core library?

What alternatives did you consider?

Does this PR contain multiple unrelated changes?

Existing PRs

Environment tested

New harness support (required if this PR adds a new harness)

Evaluation

Rigor

Human review

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

obra commented May 13, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants