SprintiQ – 开源冲刺计划，适用于 Claude Code

Source: Hacker News

Claude Code 的产品大脑。

SprintiQ Turbo 是位于 Claude Code 之上的规划层。Claude Code 负责写代码，SprintiQ 则管理构建的内容、时间和原因——冲刺规划、故事生成、速度跟踪，以及与您的 AI 编码代理的双向同步。它不是项目管理工具，而是 Claude Code 工作流的操作系统。

本仓库在 Apache 2.0 许可证下开源。您可以自由自托管、分叉和扩展。

仓库内容

• 通过 SprintiQ CLI（sprintiq watch）实现与 Claude Code 的双向同步
• 基于敏捷反模式（TAWOS）训练的 AI 驱动用户故事生成
• 冲刺计划、容量管理和速度跟踪
• 考虑角色的故事生成
• 单用户、可自托管 — 您的数据、您的基础设施、您的 Claude API 密钥

快速开始（自托管）

完整部署指南请参见 SELF_HOSTING.md。

前置条件

• Node.js 18 或更高
• Supabase 项目（免费层已足够个人使用）
• Anthropic API 密钥（Claude Sonnet 4.6 + Opus）
• Voyage AI API 密钥（用于嵌入）

Setup

git clone https://github.com/SprintiQ-Incorporated/sprintiq.git
cd sprintiq
cp env.example .env.local
# Fill in the required env vars — see SELF_HOSTING.md
npm install
npx supabase db push
npm run dev

Storage buckets

运行 supabase db push 后，在 Supabase 仪表盘（Storage → New bucket）中创建两个存储桶：

CLI

cd packages/cli
npm install
npm run build
npm link
sprintiq watch

Architecture

基于 Next.js App Router、Supabase（认证、Postgres、pgvector）、Claude Sonnet 4.6（生成）和 Voyage AI（嵌入）构建。CLI（sprintiq watch）在 Claude Code 会话与冲刺看板之间创建实时桥梁。RLS 在数据库层强制单所有者工作区隔离。

Top‑level layout:

app/        Next.js App Router 路由（页面 + API）
components/ React 组件
contexts/   React 上下文提供者
hooks/      自定义 React Hook
lib/        服务器端实用工具、服务、AI 提供者
packages/   @sprintiq/cli — AI 编码代理的 CLI 桥接
public/     静态资源
scripts/    运维脚本（迁移、审计、训练）
supabase/   数据库迁移
types/      共享 TypeScript 类型
e2e/        Playwright 端到端测试
__tests__/  Vitest 单元和集成测试

有关面向 AI 代理的项目简报，请参见 CLAUDE.md。

Development

npm run dev          # 启动 Next.js 开发服务器
npm run typecheck    # 运行 TypeScript 类型检查
npm run lint         # 运行 ESLint
npm run test         # 运行 Vitest 单元测试
npm run test:e2e     # 运行 Playwright 端到端测试

Contributing

请参阅 CONTRIBUTING.md。外部 Pull Request 将逐案评估；欢迎提交 bug 报告和安全披露。

Security

安全披露指南请参见 SECURITY.md。

License

Apache 2.0 — 详见 LICENSE。

SprintiQ Turbo 在 Apache 2.0 许可证下开源。自行托管、分叉或在其上构建。SaaS 版本位于 sprintiq.ai。