- Skills: per-project know-how the platform proposes from each succeeded run (in the background, or on request from a run), people confirm, edit, disable, delete or write; active ones enter later prompts - Export one skill as SKILL.md, or all as a zip with a directory per skill, as .claude/skills/ expects - A wish's report: every run, its stage timeline, the agent's plan, replies, commands, changed files and model usage, the change, the checks, failures, reviews and releases, and the full event log, as Markdown, or laid out for printing to PDF Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
WishForge
远程、意图驱动的软件交付平台:用一句话提出愿望(目标 + 验收标准),后端编码 Agent 在隔离环境中实现,独立验证器按受保护的命令判定,失败时把失败信息交还 Agent 自修复,通过后合入代码并按需构建、审批与部署。可以从 Web 工作台、WorkBuddy/Codex(MCP)或云 IDE 发起与跟进。
- 使用手册(使用者与本机服务维护者):docs/user-manual.md
- 需求与范围:docs/requirements.md
- 架构设计:docs/architecture.md
- 本地开发:docs/development.md
- 生产运维:docs/operations.md
- 专题参考:docs/reference/
- 本机 Claude → Gitea POC:运行说明 · 真实交付验收
快速开始
需要 Node.js 22+、npm、Git 与 Docker Compose。
npm ci
npm run setup:local
docker compose -f infra/compose.yaml up -d
npm run db:migrate
npm run db:seed
npm run dev:all
打开 http://localhost:3000,创建项目、配置验证命令、连接 Codex 凭据后即可提交第一个愿望。完整步骤见 docs/development.md。
本地开发使用
host执行模式:Agent 生成的代码与项目测试直接在本机运行,没有隔离。只在可信的项目上使用。
仓库结构
| 目录 | 内容 |
|---|---|
apps/api |
控制面 API(REST /v1、内部接口 /internal、MCP /mcp、模型代理) |
apps/web |
Web 工作台(Next.js,含 OIDC BFF) |
apps/worker |
Temporal worker:coordinator / executor / verifier / deployer |
apps/provisioner |
执行环境与 IDE 工作区的创建(local 与 kubernetes 后端) |
apps/git-service |
平台 Git 服务 |
apps/runner |
目标环境侧的部署 Runner |
apps/ide |
Theia 云 IDE、IDE 网关与协作 |
packages/contracts |
领域类型、输入校验、规范化 JSON |
packages/agent |
Agent 配置与提示词组装 |
packages/runtime |
执行器适配、Git、验证、构建与部署适配 |
packages/github、packages/artifacts |
GitHub App 客户端、对象存储 |
connectors |
Codex 与 WorkBuddy 的 MCP 接入配置 |
infra |
本地 Compose、Keycloak、Kubernetes 基线与镜像构建 |
检查
npm run format:check
npm run typecheck
npm test
需要外部服务的集成测试默认跳过,开启方式见 docs/development.md。
Description
Languages
TypeScript
83.5%
JavaScript
13.5%
CSS
2.6%
Dockerfile
0.3%
PLpgSQL
0.1%