MyBlog/docs/superpowers/plans/2026-03-16-opencode-superpowers-overview.md

OpenCode Superpowers Overview Implementation Plan

For agentic workers: REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (- [ ]) syntax for tracking.

Goal: Add one new blog post that summarizes obra/superpowers (OpenCode-first) + update the AI/OpenCode sidebar entry, matching this blog's writing style.

Architecture: One new Markdown article under src/ai/ plus a small ordering update in src/.vuepress/sidebar.ts. Use upstream README as the source-of-truth for workflow + install commands.

Tech Stack: VuePress v2 + vuepress-theme-hope, Markdown, TypeScript config.

---

Task 1: Gather upstream command strings + permalinks

Files:

• Read: ~/.config/opencode/superpowers/README.md

• Step 1: Get upstream repo HEAD SHA (for permalinks)

Run:

git -C "$HOME/.config/opencode/superpowers" rev-parse HEAD

Expected: prints a 40-char SHA.

• Step 2: Identify exact upstream snippets to copy

From upstream README.md:

• Installation commands (Claude Code official + marketplace, Cursor, Codex, OpenCode, Gemini)
• Update command (Claude Code)
• Verify Installation paragraph
• Basic Workflow list

---

Task 2: Create the new overview post

Files:

• Create: src/ai/opencode-superpowers-overview.md

• Step 1: Add frontmatter + title + <!-- more -->

Requirements:

• Chinese

• Major headings ## 一、二、三...

• Use --- thematic breaks between major sections

• Step 2: Add sections per spec

Include:

• What it is (1 screen)
• Upstream Basic Workflow (7 steps; step 4 includes "subagent-driven-development or executing-plans")
• Skill map (if/then) + links to existing posts:
  • src/ai/opencode-superpowers.md
  • src/ai/opencode-skills-playbook.md
• Install/Verify/Update quick reference with strict fenced-block counts:
  • 5 install blocks (Claude/Cursor/Codex/OpenCode/Gemini)
  • 1 verify block (2 lines)
  • 3 update blocks (Claude/OpenCode/Gemini)
  • Cursor + Codex updates as plain text notes (no fenced blocks)

---

Task 3: Update sidebar order

Files:

• Modify: src/.vuepress/sidebar.ts

• Step 1: Insert new link under AI -> OpenCode

Insert before the existing:

• text: "superpowers"
• link: "opencode-superpowers.md"

New item:

• text: "superpowers-总览"
• link: "opencode-superpowers-overview.md"

Ensure final order:

1. opencode.md
2. opencode-tui.md
3. opencode-superpowers-overview.md
4. opencode-superpowers.md
5. opencode-skills-playbook.md

---

Task 4: Verify build

Files:

• None

• Step 1: Run production build

Run:

npm run docs:build

Expected: success VuePress build completed.