docs(ai): 新增 OpenCode superpowers 文章并更新侧边栏

This commit is contained in:
2026-03-16 22:40:17 +08:00
parent dfcbc51391
commit daae331fd0
6 changed files with 1075 additions and 0 deletions

View File

@@ -0,0 +1,109 @@
# 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:
```bash
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:
```bash
npm run docs:build
```
Expected: `success VuePress build completed`.