跳到主要内容

快速入门

在 5-10 分钟内完成你的第一次 AI 辅助编程体验。

核心流程

① 安装 Opencode 桌面端

  1. 访问 Opencode 官网 下载桌面端
  2. 安装并启动应用
  3. 配置 API Key(支持多种模型提供商)

② 配置 Superpowers 技能框架

在 Opencode 中执行:

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

验证安装:询问 "帮我规划这个功能",应该自动触发 superpowers 技能。

③ 第一个任务:修改当前页面

尝试向 AI 提出你的第一个请求:

请帮我查看当前 docs/intro.md 文件,并在末尾添加一个"下一步"章节,链接到本快速入门页面。

④ 验收与迭代

AI 完成修改后:

  1. 查看修改内容(git diff)
  2. 本地预览效果(pnpm start)
  3. 如有问题,继续迭代优化

速查工具

常用命令速查

命令说明
pnpm start启动开发服务器
pnpm build构建生产版本
pnpm typecheck类型检查
/plugin update superpowers更新 Superpowers

万能 Prompt 模板

代码生成:

请帮我写一个 [语言] 函数,实现 [功能描述]。
要求:
1. [约束条件 1]
2. [约束条件 2]

Bug 调试:

我遇到了一个错误:

[错误信息]

上下文:[相关代码或操作步骤]
请帮我分析原因并提供修复方案。

代码审查:

请审查以下代码,指出潜在问题和改进建议:

[代码片段]

常见错误及解决方案

问题解决方案
AI 回复不切题提供更多上下文,明确约束条件
生成的代码有错误要求 AI 解释代码逻辑,逐步验证
文件修改超出预期使用 /freeze 技能限制编辑范围

下一步推荐阅读

  1. 工具配置 - 深度配置 Opencode 和 Superpowers
  2. Prompt 技巧 - 学习编写高效 Prompt
  3. 实战练习 - 通过真实案例练习