SuperAPI AI 工具集

steve

编程与开发

查看项目

更新于 10-15 10:25

技能介绍

用途

Steve 是一个自主开发流水线(autonomous dev pipeline),把三套系统组合在一起:

  • wavybaby:自我装备的工具链(CoVe 验证、通过 skills.sh 发现技能、MCP 服务器配置、项目配置)
  • GSD:结构化项目管理(.planning/ 目录、路线图、阶段、计划、发现、验证、状态跟踪)
  • Ralph:自主 while-true 循环(熔断器、双条件退出、会话持久化、速率限制)

整体效果是:用户描述想要什么,Steve 为任务自行装备最佳工具,生成 PRD,构建完整的 GSD 项目结构,并运行一个自主循环,用经过验证的代码执行每个计划,直到里程碑完成。

主要能力与流程

PHASE 0:装备(wavybaby)

在生成任何内容之前,先为当前项目装备最佳工具。

  1. 检测项目类型:扫描 package.json、pyproject.toml、Cargo.toml、go.mod、Gemfile、pubspec.yaml、Podfile、build.gradle,确定语言、框架、包管理器、现有依赖。
  2. 搜索并安装相关技能:使用 npx skills find 按检测到的框架、语言、项目领域搜索。按技术栈自动安装推荐技能,例如:
    • React / Next.js:npx skills add vercel-labs/agent-skills --skill vercel-react-best-practices --agent claude-code -y
    • React Native / Expo:npx skills add expo/skills --agent claude-code -y
    • Supabase:npx skills add supabase/agent-skills --agent claude-code -y
    • Stripe 支付:npx skills add stripe/skills --agent claude-code -y
    • Cloudflare:npx skills add cloudflare/skills --agent claude-code -y
    • 任意 Web 项目:npx skills add vercel-labs/agent-skills --skill web-design-guidelines --agent claude-code -y
    • 安全关键:npx skills add trailofbits/skills --agent claude-code -y
  3. 安装缺失的 MCP 服务器:检查已配置的服务器后直接安装相关项,例如:
    • Context7(始终安装,防止文档幻觉):claude mcp add context7 -- npx -y @upstash/context7-mcp
    • GitHub:claude mcp add github --transport http https://api.githubcopilot.com/mcp/
    • Supabase:claude mcp add supabase -- npx -y @supabase/mcp-server
    • Sentry:claude mcp add sentry --transport http https://mcp.sentry.dev/mcp
    • Notion:claude mcp add notion --transport http https://mcp.notion.com/mcp
    • Sequential Thinking:claude mcp add thinking -- npx -y mcp-sequentialthinking-tools
  4. 设置项目配置:如缺失则创建 settings.local.json,按技术栈配置权限(如 Node/React 允许 WebSearch、npm、pnpm、git、gh、docker、Context7 MCP、Skill 等;Python 允许 python、pip、poetry、pytest、docker-compose、git 等)。
  5. 报告装备状态:列出项目类型、已安装技能、已配置 MCP 服务器及项目配置状态。

PHASE 1:PRD 生成

在写 PRD 前进行强制性的多轮深度提问,使用 AskUserQuestion,至少覆盖 6 轮中的 4 轮:

  • 第 1 轮:愿景与用户(解决什么问题、目标用户画像、成功标准、竞品)
  • 第 2 轮:核心体验(理想用户旅程、必备功能、使用感受、即时性要求)
  • 第 3 轮:技术与平台(目标平台、后端/数据库/认证/API、技术栈偏好、实时功能、离线支持、第三方服务)
  • 第 4 轮:数据与业务逻辑(核心实体、关系、角色权限、复杂业务规则、敏感数据)
  • 第 5 轮:范围与约束(MVP 边界、截止时间、设计偏好、无障碍、国际化、合规要求)
  • 第 6 轮:边界情况与打磨(错误处理、空状态、通知、引导流程、后台管理)

随后生成 .planning/specs/PRD.md,包含概述、目标用户、用户故事(含验收标准)、技术需求(技术栈、架构、数据模型、API 端点)、界面与导航、非功能需求、MVP 范围、成功指标、开放问题等章节。生成后需用户确认再继续。

PHASE 2:GSD 项目引导

PRD 获批后创建完整 .planning/ 结构:

  • 创建目录:.planning/specs、.planning/codebase、.planning/phases
  • 生成 PROJECT.md(愿景、已验证/讨论中/范围外需求、约束、关键决策)
  • 生成 ROADMAP.md(从 PRD 派生阶段,每个阶段追溯到用户故事或技术需求;基础设施通常为 Phase 1,认证为 Phase 2,每个 Epic 对应一个或多个阶段,非功能需求成为最终打磨阶段)
  • 生成 STATE.md(当前位置、性能指标、累积上下文、会话信息)
  • 生成 config.json(自主执行模式下各确认门设为 false,安全门保持 true)
  • 生成 codebase 文档:STACK.md、ARCHITECTURE.md、STRUCTURE.md、CONVENTIONS.md(已有代码则映射,新项目则创建骨架)

PHASE 3:计划生成

仅为 Phase 1 生成完整计划,后续阶段由循环即时规划。每个计划为 {NN}-{NN}-PLAN.md,包含 phase、plan-number、type、name、objective、context、tasks(含 action、verify、done)、verification、success_criteria。计划要求原子化、1-4 小时、带验证步骤。

PHASE 4:循环配置

  1. 检查 Ralph 安装:which ralph-loop 2>/dev/null || which ralph 2>/dev/null;未安装则:
    git clone https://github.com/frankbria/ralph-claude-code.git /tmp/ralph-claude-code
    cd /tmp/ralph-claude-code && ./install.sh
    
  2. 生成 .ralphrc:包含 PROJECT_NAME、PROJECT_TYPE、MAX_CALLS_PER_HOUR=100、CLAUDE_TIMEOUT_MINUTES=20、CLAUDE_OUTPUT_FORMAT="json"、ALLOWED_TOOLS、SESSION_CONTINUITY=true、SESSION_EXPIRY_HOURS=24、TASK_SOURCES="local"、CB_NO_PROGRESS_THRESHOLD=3、CB_SAME_ERROR_THRESHOLD=5、CB_OUTPUT_DECLINE_THRESHOLD=70 等,并按项目类型调整 ALLOWED_TOOLS。
  3. 生成 PROMPT.md:告诉循环如何执行 GSD 计划并进行 CoVe 验证,要求使用已装备的技能与 MCP 服务器(如用 Context7 查询最新文档)。

PHASE 5:自主执行

运行 ralph --monitor。每次循环迭代:读取 STATE.md → 执行下一个计划(对非平凡代码进行 CoVe 验证)→ 写入 SUMMARY.md → 更新 STATE.md。熔断器在卡住时停止,所有阶段完成后退出。

适用场景

适合希望从需求描述到代码实现全流程自动化的开发项目,尤其是需要结构化项目管理、技能自动装备与自主执行循环的软件工程任务。

限制

资料未提供关于收费、价格、平台兼容性、效果保证等方面的信息。部分内容(如 PROMPT.md 的完整内容)在资料中被截断,暂未提供完整细节。