docs(ai): 新增 OpenCode superpowers 文章并更新侧边栏
This commit is contained in:
@@ -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`.
|
||||
Reference in New Issue
Block a user