compozy 是什么?

compozy 是一个 Go 写的 AI 开发全生命周期编排 CLI:把 AI 辅助开发从想法到上线串成一条流水线——可选的 Idea → PRD → TechSpec → Tasks → Execution → Review,每个阶段产出纯 markdown 工件喂给下一阶段,任务经并行 agent 探索代码库做 codebase-aware 增强后,再通过 ACP 运行时(Claude Code/Codex/Cursor/Droid/OpenCode/Pi/Gemini 等 40+ agent)并发执行,单 Go 二进制、零运行时依赖、local-first。

⭐ 2,141 Stars 🍴 108 Forks Go MIT 作者: compozy
来源:README 首段 + Highlights + How It Works 查看 GitHub 仓库 →

为什么值得关注

用 AI 写代码已普及,但「从想法到上线」的全过程仍是散落的 prompt、手动任务跟踪、复制粘贴的评审循环。compozy 把这条链路产品化成一条流水线:一条 compozy setup 把核心工作流 skill 装进 40+ agent;可选的 Idea→PRD→TechSpec→Tasks→Execution→Review 六阶段每步出 markdown 工件、可版本控制可 diff;任务不是泛 prompt,而是先派并行 agent 探索你的代码库、发现模式、把每个任务 grounding 在真实项目上下文里(codebase-aware enrichment);执行走 ACP 运行时、可换 --ide、并发批处理带超时/重试/指数退避 + 实时终端 UI;跨 run 还有两层 markdown 工作流记忆(决策/学习/错误/交接自动 compaction)。单 Go 二进制零依赖、local-first、markdown 无锁定。在「编排 agent 走完整开发生命周期」这条线上,它是工程完整度很高、且明确不绑定单一 agent 的实现。

来源:README Highlights / How It Works / Quick Start

核心功能

六阶段开发流水线(markdown 工件链)

可选的 Idea → PRD → TechSpec → Tasks → Execution → Review 流水线,每阶段产出 human-readable markdown(PRD/spec/tasks/reviews/ADR),版本控制、可 diff、可在步骤间手改,下一阶段消费上一阶段产物。有清晰 scope 可直接从 PRD 起步,想要充分研究/辩论则从 idea 起。

来源:README Highlights / Quick Start(步骤 2-9)
Codebase-aware 任务增强

任务不是泛 prompt——compozy 派并行 agent 探索你的代码库、发现现有模式,把每个任务 ground 在真实项目上下文里,让 AI 改的代码贴合项目约定而非凭空生成。

来源:README Highlights(Codebase-aware enrichment)
多 agent 并发执行(ACP,--ide 可换)

通过 ACP 兼容运行时执行任务:Claude Code/Codex/Cursor/Droid/OpenCode/Pi/Gemini 等,换 --ide 即切;并发批处理带可配超时、重试、指数退避,配实时终端 UI。daemon runtime model + Task Schema v2 驱动。

来源:README Highlights / How It Works(Daemon Runtime / Task Schema v2)
可复用 agent + 工作流记忆

把 prompt、运行时默认值、可选 agent-local MCP server 打包到 .compozy/agents//,用 compozy exec --agent 或嵌套 run_agent 调用复用。跨 run 有两层 markdown 工作流记忆——agent 继承此前每个任务的决策/学习/错误/交接,自动 compaction 保持上下文新鲜无需手动记账。

来源:README Highlights / Reusable Agents / Workflow Memory
可执行扩展(TS / Go SDK + subprocess hooks)

用 subprocess hook 拦截并修改任意流水线阶段,用 TypeScript 或 Go SDK 发布自定义 prompt decorator、生命周期 observer、review provider、skill pack。sdk/ + extensions/ + packages/ 承载这套扩展体系。

来源:README 'Extensions' / SDK support / Executable extensions
单 Go 二进制 + 一键装 40+ agent + 可嵌入

编译成一个 Go 二进制、零运行时依赖、local-first(代码数据留本机);compozy setup 交互式或 --all 把核心 skill 装进所有检测到的 40+ agent;既可当独立 CLI,也可作为 Go package import 进自己的工具。还有 compozy exec 的 ad hoc exec 模式。

来源:README Highlights / Installation / Ad Hoc Exec / Embeddable

技术架构

compozy 是 Go + TS 的大型 monorepo,核心是 Go:internal/(590 文件)是引擎实现,cmd/ + compozy.go 是 CLI 入口,pkg/ 公共库,openapi/ 定义 API,编译成单个零依赖 Go 二进制(goreleaser 发版)。TS 侧 web/(247,Web UI)、sdk/(93,扩展 SDK)、packages/(47)、extensions/(29)用 turbo + bun + vitest 管理。运行模型是 daemon runtime + Task Schema v2:流水线每阶段产出 markdown 工件(YAML frontmatter 存机读元数据),任务经并行 agent 做 codebase 探索增强后,分发到 ACP 兼容运行时并发执行(带超时/重试/退避),跨 run 用两层 markdown 记忆继承上下文并自动 compaction。可复用 agent 放 .compozy/agents//(prompt + runtime 默认 + agent-local MCP)。扩展通过 subprocess hook 拦截任意阶段 + TS/Go SDK。设计判断:把「全开发生命周期」拆成产 markdown 工件的阶段链、用 frontmatter 而非自定义 XML 存元数据、执行层抽象成 ACP 以解耦具体 agent、再用单 Go 二进制 local-first 交付,是相当成熟且不绑定单一 agent 的架构取舍;工程基建(goreleaser/turbo/husky/golangci/oxlint/cliff changelog/AUR 包)也很完整。代价是 Go+TS 双栈 + 3154 文件的大 monorepo,构建与维护复杂度高。

来源:tree + go.mod + package.json + README How It Works

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) ACP 兼容运行时(Claude Code/Codex/Cursor/Droid/OpenCode/Pi/Gemini 等 40+ agent)ACP 兼容运行时… agent-local MCP server(可选,打包在可复用 agent 内)agent-local MC… TypeScript / Go SDK — 可执行扩展(hook/decorator/observer/review provider/skill pack)TypeScript / G… goreleaser — 单二进制发版;turbo + bun — TS monorepogoreleaser markdown + YAML frontmatter — 工件与元数据格式markdown + YAM… 六阶段开发流水线(markdown 工件链)六阶段开发流水线(mar… Codebase-aware 任务增强Codebase-aware 任务… 多 agent 并发执行(ACP,--ide 可换)多 agent 并发执行(A… 可复用 agent + 工作流记忆可复用 agent + 工作… 可执行扩展(TS / Go SDK + subprocess hooks)可执行扩展(TS / Go… 单 Go 二进制 + 一键装 40+ agent + 可嵌入单 Go 二进制 + 一键装… compozy 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言Go(引擎/CLI 主体)+ TypeScript(Web UI / SDK / 扩展)框架Go 单二进制 CLI + daemon runtime + Task Schema v2;ACP(Agent Communication Protocol)执行层;Web UI 与 SDK 用 turbo + bun + vitest
ACP 兼容运行时(Claude Code/Codex/Cursor/D…agent-local MCP server(可选,打包在可复用 age…TypeScript / Go SDKgoreleasermarkdown + YAML frontmatter
单 Go 二进制、零运行时依赖、local-first;compozy setup 装 skill 到 40+ agent;可作 Go package 嵌入;goreleaser/AUR 包/husky/golangci/oxlint/cliff 工程链;MIT 协议;v0.2.x 早期
来源:go.mod + package.json + tree + README

快速上手

# 安装(见 README Installation:多平台/包管理器) # 把核心 skill 装进你的 AI agent compozy setup # 交互式:挑 agent 和 skill compozy setup --all # 全装到所有检测到的 agent # 典型流水线(可选阶段,从 idea 或直接 PRD 起步) # 1) 装 skill 2)(可选)建 Issue 3) 写 PRD 4) 写 TechSpec # 5) 拆任务(codebase-aware 增强) 6) 执行任务(多 agent 并发) # 7) 评审 8) 修评审问题 9) 迭代上线 # 切换执行用的 agent 运行时 compozy --ide claude # 或 codex / cursor / droid / opencode / pi / gemini # 复用 agent / ad hoc 执行 compozy exec --agent # 完整命令见 README CLI Reference;config 见 .compozy/ 与 Config Files 节
来源:README Installation / Quick Start / Ad Hoc Exec / CLI Reference 原文

使用场景

1. 把 AI 开发流程标准化:团队用 Idea→PRD→TechSpec→Tasks→Execution→Review 一条流水线,每步产 markdown 工件、可 review 可版本控制,替代散落的 prompt 和手动任务跟踪;2. codebase 贴合的任务执行:让任务先经并行 agent 探索代码库再执行,使 AI 改动符合项目既有模式;3. 多 agent 团队统一编排:用同一 CLI、换 --ide 在 Claude Code/Codex/Cursor 等之间切换执行运行时;4. 复用专职 agent:把常用 agent(含 prompt + MCP)打包进 .compozy/agents/ 反复用、可嵌套调用;5. 把开发流程嵌进自有工具:作为 Go package import,或用 TS/Go SDK + subprocess hook 定制流水线阶段;6. 跨 run 上下文连续:用工作流记忆让 agent 继承历史决策与交接。

来源:README Quick Start / Reusable Agents / Extensions / Workflow Memory

优势与局限

优势

  • 覆盖完整开发生命周期:不只执行代码,而是 Idea→PRD→TechSpec→Tasks→Execution→Review 全链路产 markdown 工件,把「想法到上线」做成可追溯流水线
  • 不绑定单一 agent:执行层抽象成 ACP,--ide 一换即切 Claude Code/Codex/Cursor 等 40+ agent,一条 compozy setup 装 skill 到全部,避免供应商锁定
  • codebase-aware 是真差异:派并行 agent 探索代码库、把任务 ground 在真实上下文,比泛 prompt 生成的代码更贴项目;两层工作流记忆跨 run 继承决策/交接
  • 交付与互操作干净:单 Go 二进制零运行时依赖、local-first、markdown + YAML frontmatter 无锁定可 diff,可作独立 CLI 也可作 Go package 嵌入
  • 工程基建完整:Go + TS 双栈 + turbo/bun/vitest + goreleaser + golangci/oxlint + husky + cliff changelog + AUR 包,扩展有 TS/Go SDK + subprocess hook

局限

  • 可维护性 / 复杂度风险:Go + TS 双栈、3154 文件大 monorepo(internal 590 + web 247 + sdk 93 等),构建链复杂(goreleaser + turbo + bun + 多 linter),新贡献者上手与长期维护成本高
  • 可测试性风险:核心价值是「多阶段 AI 流水线产出的工件质量」,PRD/spec/task/review 的好坏本质主观、依赖各 agent 表现,难机器化回归;vitest/Go test 主要覆盖引擎逻辑而非流程产出质量
  • 稳定性风险:仍是 0.2.x 早期,Task Schema 已到 v2 说明核心数据格式在演进,daemon runtime / 流水线阶段可能继续变,下游扩展/工件格式有跟随成本
  • 可扩展性门槛:扩展虽有 TS/Go SDK + subprocess hook,但要拦截流水线阶段需理解 daemon runtime 与 Task Schema,深度定制门槛不低;40+ agent 的 ACP 支持完整度可能参差
  • 性能 / 成本风险:六阶段流水线 + 并行 codebase 探索 + 多 agent 并发执行意味着大量 LLM 调用,token/时间成本未量化;并发批处理的资源占用与各 agent 限流叠加需实测
  • 依赖外部 agent 生态:执行依赖 ACP 兼容运行时(各 agent 自身可用性、登录、限流),compozy 本身不含模型,能力上限受所选 agent 决定
来源:综合 README + tree + go.mod + package.json + release 历史

最新版本

v0.2.4(2026-05-14)。最近 4 个 release:v0.2.1 (2026-05-01) → v0.2.2 (2026-05-09) → v0.2.3 (2026-05-09) → v0.2.4 (2026-05-14)。用 goreleaser 发单二进制 + cliff 生成 changelog + AUR 包。仓库 2026-03-28 创建,仍处 0.2.x 早期,Task Schema 已迭代到 v2。

来源:GitHub Releases API(4 个 tag)+ tree(goreleaser/cliff/aur-pkg)

总结评价

如果你想把 AI 辅助开发从「散乱 prompt」升级成「可追溯流水线」,compozy 是目前覆盖最完整的开源方案之一:Idea→PRD→TechSpec→Tasks→执行→评审全链路产 markdown 工件、codebase-aware 任务增强、不绑定单一 agent(ACP + 40+ agent)、单 Go 二进制 local-first。务实建议:1) 先 compozy setup 装核心 skill,从「直接 PRD 起步」体验流水线,再决定是否用完整 Idea 阶段;2) 它最大价值是流程标准化 + codebase 贴合,团队协作收益大于个人随手用;3) 0.2.x 早期、Task Schema 到 v2 说明格式在变,工件和扩展要做好跟随更新的预期,别锁死自定义流程;4) 多阶段 + 并行探索 + 多 agent 并发是重 LLM 操作,先评估 token/时间成本;5) 执行质量取决于你选的 ACP agent(Claude Code/Codex 等),compozy 负责编排不负责模型;6) 想嵌进自有工具就用 Go package / TS-Go SDK,但深度扩展需理解 daemon runtime 与 Task Schema。

来源:综合分析
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-22 10:19. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件