OpenCode 支持实施计划

由 Markdown 原样翻译并转换为 Astro Starlight MDX 格式。

OpenCode 支持实施计划

对于 agentic workers: REQUIRED SUB-SKILL: 使用 superpowers:executing-plans to implement this 计划 task-by-task.

Goal: 添加 full superpowers support for OpenCode.ai with a 原生 JavaScript plugin that shares core functionality with the 现有 Codex implementation.

架构: Extract common skill discovery/parsing logic into lib/skills-core.js, 重构 Codex to use it, then build OpenCode plugin using their 原生 plugin API with custom tools and session hooks.

Tech Stack: Node.js, JavaScript, OpenCode Plugin API, Git worktrees

Phase 1: 创建共享核心模块

Task 1: Extract Frontmatter Parsing

文件：

创建: lib/skills-core.js
Reference: .codex/superpowers-codex (lines 40-74)

步骤 1：创建 lib/skills-core.js with extractFrontmatter function

#!/usr/bin/env node

const fs = require('fs');
const path = require('path');

/**
 * Extract YAML frontmatter from a skill file.
 * Current format:
 * ---
 * name: skill-name
 * description: Use when [condition] - [what it does]
 * ---
 *
 * @param {string} filePath - Path to SKILL.md file
 * @returns {{name: string, description: string}}
 */
function extractFrontmatter(filePath) {
    try {
        const content = fs.readFileSync(filePath, 'utf8');
        const lines = content.split('\n');

        let inFrontmatter = false;
        let name = '';
        let description = '';

        for (const line of lines) {
            if (line.trim() === '---') {
                if (inFrontmatter) break;
                inFrontmatter = true;
                continue;
            }

            if (inFrontmatter) {
                const match = line.match(/^(\w+):\s*(.*)$/);
                if (match) {
                    const [, key, value] = match;
                    switch (key) {
                        case 'name':
                            name = value.trim();
                            break;
                        case 'description':
                            description = value.trim();
                            break;
                    }
                }
            }
        }

        return { name, description };
    } catch (error) {
        return { name: '', description: '' };
    }
}

module.exports = {
    extractFrontmatter
};

步骤 2：验证 file was created

运行: ls -l lib/skills-core.js 预期：文件存在

步骤 3：提交

git add lib/skills-core.js
git commit -m "feat: create shared skills core module with frontmatter parser"

Task 2: Extract Skill Discovery Logic

文件：

修改: lib/skills-core.js
Reference: .codex/superpowers-codex (lines 97-136)

步骤 1：添加 findSkillsInDir function to skills-core.js

添加 before module.exports:

/**
 * Find all SKILL.md files in a directory recursively.
 *
 * @param {string} dir - Directory to search
 * @param {string} sourceType - 'personal' or 'superpowers' for namespacing
 * @param {number} maxDepth - Maximum recursion depth (default: 3)
 * @returns {Array<{path: string, name: string, description: string, sourceType: string}>}
 */
function findSkillsInDir(dir, sourceType, maxDepth = 3) {
    const skills = [];

    if (!fs.existsSync(dir)) return skills;

    function recurse(currentDir, depth) {
        if (depth > maxDepth) return;

        const entries = fs.readdirSync(currentDir, { withFileTypes: true });

        for (const entry of entries) {
            const fullPath = path.join(currentDir, entry.name);

            if (entry.isDirectory()) {
                // Check for SKILL.md in this directory
                const skillFile = path.join(fullPath, 'SKILL.md');
                if (fs.existsSync(skillFile)) {
                    const { name, description } = extractFrontmatter(skillFile);
                    skills.push({
                        path: fullPath,
                        skillFile: skillFile,
                        name: name || entry.name,
                        description: description || '',
                        sourceType: sourceType
                    });
                }

                // Recurse into subdirectories
                recurse(fullPath, depth + 1);
            }
        }
    }

    recurse(dir, 0);
    return skills;
}

步骤 2：更新 module.exports

替换 the exports line with:

module.exports = {
    extractFrontmatter,
    findSkillsInDir
};

步骤 3：验证语法

运行: node -c lib/skills-core.js 预期: No output (成功)

步骤 4：提交

git add lib/skills-core.js
git commit -m "feat: add skill discovery function to core module"

Task 3: Extract Skill Resolution Logic

文件：

修改: lib/skills-core.js
Reference: .codex/superpowers-codex (lines 212-280)

步骤 1：添加 resolveSkillPath function

添加 before module.exports:

/**
 * Resolve a skill name to its file path, handling shadowing
 * (personal skills override superpowers skills).
 *
 * @param {string} skillName - Name like "superpowers:brainstorming" or "my-skill"
 * @param {string} superpowersDir - Path to superpowers skills directory
 * @param {string} personalDir - Path to personal skills directory
 * @returns {{skillFile: string, sourceType: string, skillPath: string} | null}
 */
function resolveSkillPath(skillName, superpowersDir, personalDir) {
    // Strip superpowers: prefix if present
    const forceSuperpowers = skillName.startsWith('superpowers:');
    const actualSkillName = forceSuperpowers ? skillName.replace(/^superpowers:/, '') : skillName;

    // Try personal skills first (unless explicitly superpowers:)
    if (!forceSuperpowers && personalDir) {
        const personalPath = path.join(personalDir, actualSkillName);
        const personalSkillFile = path.join(personalPath, 'SKILL.md');
        if (fs.existsSync(personalSkillFile)) {
            return {
                skillFile: personalSkillFile,
                sourceType: 'personal',
                skillPath: actualSkillName
            };
        }
    }

    // Try superpowers skills
    if (superpowersDir) {
        const superpowersPath = path.join(superpowersDir, actualSkillName);
        const superpowersSkillFile = path.join(superpowersPath, 'SKILL.md');
        if (fs.existsSync(superpowersSkillFile)) {
            return {
                skillFile: superpowersSkillFile,
                sourceType: 'superpowers',
                skillPath: actualSkillName
            };
        }
    }

    return null;
}

步骤 2：更新 module.exports

module.exports = {
    extractFrontmatter,
    findSkillsInDir,
    resolveSkillPath
};

步骤 3：验证语法

运行: node -c lib/skills-core.js 预期：没有输出

步骤 4：提交

git add lib/skills-core.js
git commit -m "feat: add skill path resolution with shadowing support"

Task 4: Extract 更新 Check Logic

文件：

修改: lib/skills-core.js
Reference: .codex/superpowers-codex (lines 16-38)

步骤 1：添加 checkForUpdates function

添加 at top after requires:

const { execSync } = require('child_process');

添加 before module.exports:

/**
 * Check if a git repository has updates available.
 *
 * @param {string} repoDir - Path to git repository
 * @returns {boolean} - True if updates are available
 */
function checkForUpdates(repoDir) {
    try {
        // Quick check with 3 second timeout to avoid delays if network is down
        const output = execSync('git fetch origin && git status --porcelain=v1 --branch', {
            cwd: repoDir,
            timeout: 3000,
            encoding: 'utf8',
            stdio: 'pipe'
        });

        // Parse git status output to see if we're behind
        const statusLines = output.split('\n');
        for (const line of statusLines) {
            if (line.startsWith('## ') && line.includes('[behind ')) {
                return true; // We're behind remote
            }
        }
        return false; // Up to date
    } catch (error) {
        // Network down, git error, timeout, etc. - don't block bootstrap
        return false;
    }
}

步骤 2：更新 module.exports

module.exports = {
    extractFrontmatter,
    findSkillsInDir,
    resolveSkillPath,
    checkForUpdates
};

步骤 3：验证语法

运行: node -c lib/skills-core.js 预期：没有输出

步骤 4：提交

git add lib/skills-core.js
git commit -m "feat: add git update checking to core module"

Phase 2: Refactor Codex to 使用 Shared Core

Task 5: 更新 Codex to Import Shared Core

文件：

修改: .codex/superpowers-codex (add import at top)

步骤 1：添加 import statement

After the 现有 requires at top of file (around line 6), add:

const skillsCore = require('../lib/skills-core');

步骤 2：验证语法

运行: node -c .codex/superpowers-codex 预期：没有输出

步骤 3：提交

git add .codex/superpowers-codex
git commit -m "refactor: import shared skills core in codex"

Task 6: 替换 extractFrontmatter with Core Version

文件：

修改: .codex/superpowers-codex (lines 40-74)

步骤 1：移除本地 extractFrontmatter function

删除 lines 40-74 (the entire extractFrontmatter function definition).

步骤 2：更新 all extractFrontmatter calls

Find and replace all calls from extractFrontmatter( to skillsCore.extractFrontmatter(

Affected lines approximately: 90, 310

步骤 3：验证 script still works

运行: .codex/superpowers-codex find-skills | head -20 预期：显示 skills 列表

步骤 4：提交

git add .codex/superpowers-codex
git commit -m "refactor: use shared extractFrontmatter in codex"

Task 7: 替换 findSkillsInDir with Core Version

文件：

修改: .codex/superpowers-codex (lines 97-136, approximately)

步骤 1：移除本地 findSkillsInDir function

删除 the entire findSkillsInDir function definition (approximately lines 97-136).

步骤 2：更新 all findSkillsInDir calls

替换 calls from findSkillsInDir( to skillsCore.findSkillsInDir(

步骤 3：验证 script still works

运行: .codex/superpowers-codex find-skills | head -20 预期：显示 skills 列表

步骤 4：提交

git add .codex/superpowers-codex
git commit -m "refactor: use shared findSkillsInDir in codex"

Task 8: 替换 checkForUpdates with Core Version

文件：

修改: .codex/superpowers-codex (lines 16-38, approximately)

步骤 1：移除本地 checkForUpdates function

删除 the entire checkForUpdates function definition.

步骤 2：更新 all checkForUpdates calls

替换 calls from checkForUpdates( to skillsCore.checkForUpdates(

步骤 3：验证 script still works

运行: .codex/superpowers-codex bootstrap | head -50 预期: Shows bootstrap content

步骤 4：提交

git add .codex/superpowers-codex
git commit -m "refactor: use shared checkForUpdates in codex"

Phase 3: Build OpenCode Plugin

Task 9: 创建 OpenCode Plugin Directory Structure

文件：

创建: .opencode/plugin/superpowers.js

步骤 1：创建目录

运行: mkdir -p .opencode/plugin

步骤 2：创建 basic plugin file

#!/usr/bin/env node

/**
 * Superpowers plugin for OpenCode.ai
 *
 * Provides custom tools for loading and discovering skills,
 * with automatic bootstrap on session start.
 */

const skillsCore = require('../../lib/skills-core');
const path = require('path');
const fs = require('fs');
const os = require('os');

const homeDir = os.homedir();
const superpowersSkillsDir = path.join(homeDir, '.config/opencode/superpowers/skills');
const personalSkillsDir = path.join(homeDir, '.config/opencode/skills');

/**
 * OpenCode plugin entry point
 */
export const SuperpowersPlugin = async ({ project, client, $, directory, worktree }) => {
  return {
    // Custom tools and hooks will go here
  };
};

步骤 3：验证 file was created

运行: ls -l .opencode/plugin/superpowers.js 预期：文件存在

步骤 4：提交

git add .opencode/plugin/superpowers.js
git commit -m "feat: create opencode plugin scaffold"

Task 10: Implement use_skill Tool

文件：

修改: .opencode/plugin/superpowers.js

步骤 1：添加 use_skill tool 实施

替换 the plugin return statement with:

export const SuperpowersPlugin = async ({ project, client, $, directory, worktree }) => {
  // Import zod for schema validation
  const { z } = await import('zod');

  return {
    tools: [
      {
        name: 'use_skill',
        description: 'Load and read a specific skill to guide your work. Skills contain proven workflows, mandatory processes, and expert techniques.',
        schema: z.object({
          skill_name: z.string().describe('Name of the skill to load (e.g., "superpowers:brainstorming" or "my-custom-skill")')
        }),
        execute: async ({ skill_name }) => {
          // Resolve skill path (handles shadowing: personal > superpowers)
          const resolved = skillsCore.resolveSkillPath(
            skill_name,
            superpowersSkillsDir,
            personalSkillsDir
          );

          if (!resolved) {
            return `Error: Skill "${skill_name}" not found.\n\nRun find_skills to see available skills.`;
          }

          // Read skill content
          const fullContent = fs.readFileSync(resolved.skillFile, 'utf8');
          const { name, description } = skillsCore.extractFrontmatter(resolved.skillFile);

          // Extract content after frontmatter
          const lines = fullContent.split('\n');
          let inFrontmatter = false;
          let frontmatterEnded = false;
          const contentLines = [];

          for (const line of lines) {
            if (line.trim() === '---') {
              if (inFrontmatter) {
                frontmatterEnded = true;
                continue;
              }
              inFrontmatter = true;
              continue;
            }

            if (frontmatterEnded || !inFrontmatter) {
              contentLines.push(line);
            }
          }

          const content = contentLines.join('\n').trim();
          const skillDirectory = path.dirname(resolved.skillFile);

          // Format output similar to Claude Code's Skill tool
          return `# ${name || skill_name}
# ${description || ''}
# Supporting tools and docs are in ${skillDirectory}
# ============================================

${content}`;
        }
      }
    ]
  };
};

步骤 2：验证语法

运行: node -c .opencode/plugin/superpowers.js 预期：没有输出

步骤 3：提交

git add .opencode/plugin/superpowers.js
git commit -m "feat: implement use_skill tool for opencode"

Task 11: Implement find_skills Tool

文件：

修改: .opencode/plugin/superpowers.js

步骤 1：添加 find_skills tool to tools array

添加 after the use_skill tool definition, before closing the tools array:

      {
        name: 'find_skills',
        description: 'List all available skills in the superpowers and personal skill libraries.',
        schema: z.object({}),
        execute: async () => {
          // Find skills in both directories
          const superpowersSkills = skillsCore.findSkillsInDir(
            superpowersSkillsDir,
            'superpowers',
            3
          );
          const personalSkills = skillsCore.findSkillsInDir(
            personalSkillsDir,
            'personal',
            3
          );

          // Combine and format skills list
          const allSkills = [...personalSkills, ...superpowersSkills];

          if (allSkills.length === 0) {
            return 'No skills found. Install superpowers skills to ~/.config/opencode/superpowers/skills/';
          }

          let output = 'Available skills:\n\n';

          for (const skill of allSkills) {
            const namespace = skill.sourceType === 'personal' ? '' : 'superpowers:';
            const skillName = skill.name || path.basename(skill.path);

            output += `${namespace}${skillName}\n`;
            if (skill.description) {
              output += `  ${skill.description}\n`;
            }
            output += `  Directory: ${skill.path}\n\n`;
          }

          return output;
        }
      }

步骤 2：验证语法

运行: node -c .opencode/plugin/superpowers.js 预期：没有输出

步骤 3：提交

git add .opencode/plugin/superpowers.js
git commit -m "feat: implement find_skills tool for opencode"

Task 12: Implement Session Start Hook

文件：

修改: .opencode/plugin/superpowers.js

步骤 1：添加 session.started hook

After the tools array, add:

    'session.started': async () => {
      // Read using-superpowers skill content
      const usingSuperpowersPath = skillsCore.resolveSkillPath(
        'using-superpowers',
        superpowersSkillsDir,
        personalSkillsDir
      );

      let usingSuperpowersContent = '';
      if (usingSuperpowersPath) {
        const fullContent = fs.readFileSync(usingSuperpowersPath.skillFile, 'utf8');
        // Strip frontmatter
        const lines = fullContent.split('\n');
        let inFrontmatter = false;
        let frontmatterEnded = false;
        const contentLines = [];

        for (const line of lines) {
          if (line.trim() === '---') {
            if (inFrontmatter) {
              frontmatterEnded = true;
              continue;
            }
            inFrontmatter = true;
            continue;
          }

          if (frontmatterEnded || !inFrontmatter) {
            contentLines.push(line);
          }
        }

        usingSuperpowersContent = contentLines.join('\n').trim();
      }

      // Tool mapping instructions
      const toolMapping = `
**Tool Mapping for OpenCode:**
When skills reference tools you don't have, substitute OpenCode equivalents:
- \`TodoWrite\` → \`update_plan\` (your planning/task tracking tool)
- \`Task\` tool with subagents → Use OpenCode's subagent system (@mention syntax or automatic dispatch)
- \`Skill\` tool → \`use_skill\` custom tool (already available)
- \`Read\`, \`Write\`, \`Edit\`, \`Bash\` → Use your native tools

**Skill directories contain supporting files:**
- Scripts you can run with bash tool
- Additional documentation you can read
- Utilities and helpers specific to that skill

**Skills naming:**
- Superpowers skills: \`superpowers:skill-name\` (from ~/.config/opencode/superpowers/skills/)
- Personal skills: \`skill-name\` (from ~/.config/opencode/skills/)
- Personal skills override superpowers skills when names match
`;

      // Check for updates (non-blocking)
      const hasUpdates = skillsCore.checkForUpdates(
        path.join(homeDir, '.config/opencode/superpowers')
      );

      const updateNotice = hasUpdates ?
        '\n\n⚠️ **Updates available!** Run `cd ~/.config/opencode/superpowers && git pull` to update superpowers.' :
        '';

      // Return context to inject into session
      return {
        context: `<EXTREMELY_IMPORTANT>
You have superpowers.

**Below is the full content of your 'superpowers:using-superpowers' skill - your introduction to using skills. For all other skills, use the 'use_skill' tool:**

${usingSuperpowersContent}

${toolMapping}${updateNotice}
</EXTREMELY_IMPORTANT>`
      };
    }

步骤 2：验证语法

运行: node -c .opencode/plugin/superpowers.js 预期：没有输出

步骤 3：提交

git add .opencode/plugin/superpowers.js
git commit -m "feat: implement session.started hook for opencode"

Phase 4: Documentation

Task 13: 创建 OpenCode 安装 Guide

文件：

创建: .opencode/INSTALL.md

步骤 1：创建安装 guide

# Installing Superpowers for OpenCode

## Prerequisites

- [OpenCode.ai](https://opencode.ai) installed
- Node.js installed
- Git installed

## Installation Steps

### 1. Install Superpowers Skills

```bash
# Clone superpowers skills to OpenCode 配置 目录
mkdir -p ~/.config/opencode/superpowers
git clone https://github.com/obra/superpowers.git ~/.config/opencode/superpowers

2. Install the Plugin

The plugin is included in the superpowers repository you just cloned.

OpenCode will automatically discover it from:

~/.config/opencode/superpowers/.opencode/plugin/superpowers.js

Or you can link it to the project-local plugin directory:

# In your OpenCode 项目
mkdir -p .opencode/plugin
ln -s ~/.config/opencode/superpowers/.opencode/plugin/superpowers.js .opencode/plugin/superpowers.js

3. Restart OpenCode

Restart OpenCode to load the plugin. On the next session, you should see:

You have superpowers.

Usage

Finding Skills

Use the find_skills tool to list all available skills:

use find_skills tool

Loading a Skill

Use the use_skill tool to load a specific skill:

use use_skill tool with skill_name: "superpowers:brainstorming"

Personal Skills

Create your own skills in ~/.config/opencode/skills/:

mkdir -p ~/.config/opencode/skills/my-skill

Create ~/.config/opencode/skills/my-skill/SKILL.md:

---
name: my-skill
description: 使用 when [condition] - [what it does]
---

# My Skill

[Your skill content here]

Personal skills override superpowers skills with the same name.

Updating

cd ~/.config/opencode/superpowers
git pull

Troubleshooting

Plugin not loading

Check plugin file exists: ls ~/.config/opencode/superpowers/.opencode/plugin/superpowers.js
Check OpenCode logs for errors
Verify Node.js is installed: node --version

Skills not found

Verify skills directory exists: ls ~/.config/opencode/superpowers/skills
Use find_skills tool to see what’s discovered
Check file structure: each skill should have a SKILL.md file

Tool mapping issues

When a skill references a Claude Code tool you don’t have:

TodoWrite → use update_plan
Task with subagents → use @mention syntax to invoke OpenCode subagents
Skill → use use_skill tool
File operations → use your native tools

Getting Help

Report issues: https://github.com/obra/superpowers/issues
Documentation: https://github.com/obra/superpowers

**步骤 2： 验证 file created**

运行: `ls -l .opencode/INSTALL.md`
预期：文件存在

**步骤 3：提交**

```bash
git add .opencode/INSTALL.md
git commit -m "docs: add opencode installation guide"

Task 14: 更新 Main README

文件：

修改: README.md

步骤 1：添加 OpenCode section

Find the section about 受支持平台 (search for “Codex” in the file), and add after it:

### OpenCode

Superpowers works with [OpenCode.ai](https://opencode.ai) through a native JavaScript plugin.

**Installation:** See [.opencode/INSTALL.md](.opencode/INSTALL.md)

**Features:**
- Custom tools: `use_skill` and `find_skills`
- Automatic session bootstrap
- Personal skills with shadowing
- Supporting files and scripts access

步骤 2：验证 formatting

运行: grep -A 10 "### OpenCode" README.md 预期: Shows the section you added

步骤 3：提交

git add README.md
git commit -m "docs: add opencode support to readme"

Task 15: 更新 Release Notes

文件：

修改: RELEASE-NOTES.md

步骤 1：添加 entry for OpenCode support

At the top of the file (after the header), add:

## [Unreleased]

### Added

- **OpenCode Support**: Native JavaScript plugin for OpenCode.ai
  - Custom tools: `use_skill` and `find_skills`
  - Automatic session bootstrap with tool mapping instructions
  - Shared core module (`lib/skills-core.js`) for code reuse
  - Installation guide in `.opencode/INSTALL.md`

### Changed

- **Refactored Codex Implementation**: Now uses shared `lib/skills-core.js` module
  - Eliminates code duplication between Codex and OpenCode
  - Single source of truth for skill discovery and parsing

---

步骤 2：验证 formatting

运行: head -30 RELEASE-NOTES.md 预期: Shows your 新 section

步骤 3：提交

git add RELEASE-NOTES.md
git commit -m "docs: add opencode support to release notes"

Phase 5: Final 验证

Task 16: Test Codex Still Works

文件：

Test: .codex/superpowers-codex

步骤 1： Test find-skills command

运行: .codex/superpowers-codex find-skills | head -20 预期: Shows list of skills with names and descriptions

步骤 2： Test use-skill command

运行: .codex/superpowers-codex use-skill superpowers:brainstorming | head -20 预期: Shows brainstorming skill content

步骤 3： Test bootstrap command

运行: .codex/superpowers-codex bootstrap | head -30 预期: Shows bootstrap content with instructions

步骤 4：如果 all tests pass, record 成功

无需提交 —— 这只是验证。

Task 17: 验证 File Structure

文件：

Check: All 新 files exist

步骤 1：验证 all files created

运行：

ls -l lib/skills-core.js
ls -l .opencode/plugin/superpowers.js
ls -l .opencode/INSTALL.md

预期: All files exist

步骤 2：验证目录 structure

运行: tree -L 2 .opencode/ (or find .opencode -type f if tree not 可用) 预期：

.opencode/
├── INSTALL.md
└── plugin/
    └── superpowers.js

步骤 3：如果 structure correct, proceed

无需提交 —— 这只是验证。

Task 18: Final 提交 and 总结

文件：

Check: git status

步骤 1： Check git status

运行: git status 预期: Working tree clean, all changes committed

步骤 2： Review commit log

运行: git log --oneline -20 预期: Shows all commits from this 实施

步骤 3：创建 summary document

创建 a completion summary showing:

Total commits made
文件 created: lib/skills-core.js, .opencode/plugin/superpowers.js, .opencode/INSTALL.md
文件 modified: .codex/superpowers-codex, README.md, RELEASE-NOTES.md
Testing performed: Codex commands verified
Ready for: Testing with actual OpenCode 安装

步骤 4： Report completion

Present summary to user and offer to:

Push to remote
创建 pull request
Test with real OpenCode 安装 (requires OpenCode installed)

Testing Guide (Manual - Requires OpenCode)

These steps require OpenCode to be installed and are not part of the automated 实施:

Install skills: Follow .opencode/INSTALL.md
Start OpenCode session: 验证 bootstrap appears
Test find_skills: Should list all 可用 skills
Test use_skill: Load a skill and verify content appears
Test supporting files: 验证 skill 目录 paths are accessible
Test 个人 skills: 创建 a 个人 skill and verify it shadows core
Test 工具映射: 验证 TodoWrite → update_plan 映射 works

Success Criteria

lib/skills-core.js created with all core functions
.codex/superpowers-codex refactored to use shared core
Codex commands still work (find-skills, use-skill, bootstrap)
.opencode/plugin/superpowers.js created with tools and hooks
安装 guide created
README and RELEASE-NOTES updated
All changes committed
Working tree clean

OpenCode 支持实施计划

OpenCode 支持实施计划

Phase 1: 创建 共享核心模块

Task 1: Extract Frontmatter Parsing

Task 2: Extract Skill Discovery Logic

Task 3: Extract Skill Resolution Logic

Task 4: Extract 更新 Check Logic

Phase 2: Refactor Codex to 使用 Shared Core

Task 5: 更新 Codex to Import Shared Core

Task 6: 替换 extractFrontmatter with Core Version

Task 7: 替换 findSkillsInDir with Core Version

Task 8: 替换 checkForUpdates with Core Version

Phase 3: Build OpenCode Plugin

Task 9: 创建 OpenCode Plugin Directory Structure

Task 10: Implement use_skill Tool

Task 11: Implement find_skills Tool

Task 12: Implement Session Start Hook

Phase 4: Documentation

Task 13: 创建 OpenCode 安装 Guide

2. Install the Plugin

3. Restart OpenCode

Usage

Finding Skills

Loading a Skill

Personal Skills

Updating

Troubleshooting

Plugin not loading

Skills not found

Tool mapping issues

Getting Help

Task 14: 更新 Main README

Task 15: 更新 Release Notes

Phase 5: Final 验证

Task 16: Test Codex Still Works

Task 17: 验证 File Structure

Task 18: Final 提交 and 总结

Testing Guide (Manual - Requires OpenCode)

Success Criteria

Get started

Windows

Plans

Superpowers

Phase 1: 创建共享核心模块