README.vscode.md

Superpowers 中文版 — VS Code (Copilot) 安装指南

在 VS Code + GitHub Copilot 中使用 superpowers-zh 的完整指南。

前置条件

• VS Code（最新版本）
• GitHub Copilot 扩展（免费版或付费版均可）

快速安装

cd /your/project
npx superpowers-zh

安装脚本会自动检测 .github/ 目录并将 skills 复制到该目录。

手动安装

git clone https://github.com/jnMetaCode/superpowers-zh.git
mkdir -p /your/project/.github/superpowers
cp -r superpowers-zh/skills/* /your/project/.github/superpowers/

工作原理

VS Code Copilot 使用 .github/copilot-instructions.md 作为项目级自定义指令：

• 位置：项目根目录 .github/copilot-instructions.md
• 格式：Markdown
• 生效范围：该工作区内的所有 Copilot Chat 和内联补全
• 自动加载：保存文件后立即生效，无需重启

推荐配置

由于 Copilot 主要通过单个指令文件工作，建议创建 .github/copilot-instructions.md 引用 skills：

# Copilot 自定义指令

## 工作流方法论

本项目使用 superpowers-zh skills 框架。开始新任务前，请参考以下方法论：

- 新需求 → 先头脑风暴（.github/superpowers/brainstorming/SKILL.md）
- 写代码 → TDD 驱动（.github/superpowers/test-driven-development/SKILL.md）
- 修 Bug → 系统化调试（.github/superpowers/systematic-debugging/SKILL.md）
- 审查代码 → 中文代码审查（.github/superpowers/chinese-code-review/SKILL.md）

## 中文项目规范

- 代码注释和文档使用中文
- Git commit 遵循中文提交规范
- 技术术语保留英文原文

使用 .instructions.md 文件（推荐）

VS Code 还支持更细粒度的 .instructions.md 文件：

.github/
  copilot-instructions.md          # 全局指令
  .instructions/
    typescript.instructions.md     # TypeScript 文件专用
    testing.instructions.md        # 测试相关

使用

在 VS Code 中：

• Copilot Chat（Ctrl+Shift+I）：直接引用 skill 名称
• 内联补全：自动遵循 copilot-instructions.md 中的规则
• /init：在 Chat 中输入，自动生成项目配置

局限性

VS Code Copilot 不像 Claude Code 那样支持 Skill 工具或子 Agent 派遣。以下 skills 需要手动参考而非自动执行：

• 派遣并行 Agent（需要 Agent 框架支持）
• 子 Agent 驱动开发（需要 Agent 框架支持）
• Git Worktree 使用（需要终端操作）

其他方法论类 skills（头脑风暴、TDD、调试、代码审查等）完全兼容。

更新

cd /your/project
npx superpowers-zh

获取帮助

• 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues
• VS Code Copilot 文档：https://code.visualstudio.com/docs/copilot/customization/custom-instructions