Consort保持AI-write代码的清洁和正确: spec-first和测试驱动,由定型状态机驱动,带有人与人认可门并具有不可改变的测试. 工程学科不再由模特随意决定 每个绿色都是真正的Lakebase数据库的活生生分支上的测试,通过合同执行,而不是建议.
相克取其名出自音乐领域. A 类 组合 是一个音乐会演奏的合唱团:每个音乐家都持有一部分,一个指挥家能及时保持. 商号是,应用到构建软件。 一组特工各从软件生命周期取出一个熟悉的角色——一个谱作者,一个建筑师,一个DBA,一个测试策略师,一个UX设计师,以及键盘上的导航员/司机配对——而产品拥有者是人类自己的座位(你,或者一个无头站着的"人代"),一个决定式指挥者使它们保持顺序,人类批准每个门. 没有代理扮演另一个角色.
共和党的建设. 组合构建 交易应用程序后端 (一个API,以及可选的网络用户界面) 湖边, Databricks 的无服务器, Postgres 兼容的 OLTP 数据库, 大约在一秒内分行. 每个git分支与自己的Lakebase分支对接,因此每个分支都有一个真实的,孤立的数据库,而计划会随着代码的锁入而进化. 它不用于三角洲湖屋,ETL,分析器,或BI;它用于在Postgres上建立app后置. 见 docs/positioning.md 用来比拟其他光谱第一工具.
快开始
设相相方便. 复制下面的命令并将其输入任何终端窗口.
# Install: doctor + Claude Code plugin + toolkit (needs a Lakebase-enabled Databricks workspace)
bash <(curl -sL https://tinyurl.com/consort-bootstrap)
然后,运行 /consort:start 在您的代理会话中. 开始 拥有先决条件 和完全走过.
为什么是同党
AI特工快速地写出代码,但你不能相信代码是正确或可以长期维持的. 他们自己标记一个任务"done",没有后面的测试,漂出请求,弱化一个测试以达到绿色,缠绕地层,并且通过上下文重置失去计划. 数据库是最难正确的地方: 它是你无法低廉的分支的依赖, 所以它被假冒的模型 与生产同步脱节, 或者在一个中转箱之间共享测试 悄悄的偏离.
Lakebase消除了这种限制。 数据库分支是一个真实的,受管的,在大约一秒钟内创建的拷贝上写作的拷贝,所以作品会以真实的数据运行而不是模拟. 康克在此基础上使代理的"done"可被检查. 每一增量是:
- 根据真实数据核实:"绿色"指一个真正的测试跑者通过对一个活的数据库分支,而不是一个代理的说道.
- 独立审查:写代码的代理人从来不是判断它的人.
- 光谱第一和不可改变:意图被冻结在被散列的门上,在一个单位的工作范围内,测试不能被编辑以强制通过.
- 决定性驱动:控制回路被编译出,因此不能漂移,跳过一步,或者在长会话后迷失.
- 人类:大门没有关闭,没有你的批准,任何东西都不能越过一个.
何以能使相会相别相. 其他spec-first框架要求代理遵守:强烈的spec然后是被信任的构建(Spec Kit),或者坚定的测试-第一规则,模型被告知要荣誉(超能力). 在绿色的压力下,一个特工可以搁置一边。 Consort将控件放入一个确定性状态的机器中 代理运行但不能编辑: 路由是代码, 人-批准门失败关闭, 测试在一个单位工作内是不可改变的, 绿色意味着真实运行与真实的数据库相对. 工程纪律通过合同而不是建议来执行.
域是区别的另一半. 组合是用来建造和演变的 lakebase Postgres 上的应用程序后端,使用一秒数据库分支,使测试驱动的开发安全. 这不是一个数据工程工具:没有ETL或ELT,没有分析器,BI,或仪表板,没有Lakeflow / 声明管道 / Jobs / 笔记本,没有Spark或仓库计算,也没有对三角洲湖屋或统一目录分析表的工作. 它不是任何再投资的即时或技能包;它是一个决定性的管弦乐器,与Lakebase-paire项目相连.
| 组合 | GitHub 光谱套件 | 超级大国 | |
|---|---|---|---|
| 执行 | 决定状态机器 代理运行在内部但不能编辑 | 强光谱,然后是值得信赖的构造 | 初试规则 模型被告知荣誉 |
| "绿色"的意思 | 一个真正的测试运行在现场, 丢弃的邮政分行 | 经纪人的报告 | 本地红- 绿- 成因证书 |
| 底盘 | Live Lakebase (Postgres / OLTP) 复制写分行 | 无基础设施 | 无基础设施,当地 |
| 域名 | 由 Postgres 支持的交易应用程序 | 一般软件 | 一般软件 |
| 盖茨 | 无法关闭的人类认可大门 | 咨询 | 咨询 |
运行在你的编辑器. Consort是终端第一,但检测并发射到任何VS Code兼容的IDE(VS Code, Cursor等). 一开始它主动提出 打开您的项目及其 组合扩展 或者继续从终点站开车 扩展是一个现场观看器,它让你与Consort正在建造的东西相接:对接的分枝,目前的相和出闸口,以及每个角色的进步,逐个转弯,每个文物在降落时都浮出水面.
完整的定位、比较和FAQ,见 docs/positioning.md新到情侣? 开始于 启动博客帖;方法在文件中写出 引入组合 (arXiv),将发表另一份论文.
综艺节目
每个特工都有一个顾虑,只能通过它所生产的文物和它所消耗的文物进行交流,按其生命周期运行的顺序. 没有共享的内存,每个工作一个: Spec Author所制作的光谱是建筑师评论员所读到的,DBA和测试策略师的合同依次以.
| 探员 | 生命周期作用 | 拥有 |
|---|---|---|
| 产品所有人 | 产品 | 积压和每个故事的接受标准 |
| 光谱作者 | 分析 | 结构化、可测试的规格 |
| 建筑设计评论员 | 建筑 | 分层透镜, NFRs, 以及持久性的不变量 |
| 华盛顿银行 | 数据 | 物质计划和逐层迁移计划 |
| 测试战略家 | 测试设计 | 从ACs中抽取的命令主测试列表 |
| UX 设计器 | 经历 | 界面设计,用于构建用户的工作 |
| 导航 | 测试+审查 | 测试失败(RED),并审查答案代码 |
| 驱动程序 | 执行情况 | 最小的诚实代码(GREEN),然后是重构 |
如何运作
组合是小增量的循环, /plan -> /design -> /build -> /deploy你决定每个门:
- 设计( 第一部). 意向变成了一种规格和将加以证明的测试清单,然后被冻结在被散开的门上,因此目标无法移动中建. Spec Author, Architective Reviewer, DBA, and Test Strategist 各自都加入了自己的部分(外加UX Designer用于用户造型工作).
- 构建(由测试驱动). 导航员写一个失败的测试; 驱动程序让它通过最少的代码, 诚实地通过, 然后重构, 每个周期对应真实数据的复制/ 写入分支 。 无法验证通往固定修补的路线.
- 部署+促进(决定因素). 管弦乐家不是代理人,负责部署和核实增量,并驱动PR、CI、合并和父母一级的迁移。 你批准部署和提升大门.
在相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相.
开始
步骤0:安装 Consort + 设置您的环境. Conform运行与真正的Lakebase数据库相悖(没有模拟模式),因此首先必须使用一些工具和Lakebase启用的工作空间. 一个命令检测缺失的东西,提出安装,安装克洛德代码插件,并预下载 Consort 工具包(因此您的第一个工程的设置不会停止下载):
bash <(curl -sL https://tinyurl.com/consort-bootstrap)
医生验证了Databricks CLI(工作空间) 湖库启用),加节点20+,Python 3.10+,JDK 17+, gh,和npm,每个都有固定提示. /consort:start 财务报告和审定财务报表 lakebase-create-project 开着和大门一样的医生 并且拒绝提供直到它通过, 所以如果你跳过这个步骤, 检查仍然会发生 在任何东西创建之前。 (希望自己去检查一下? )? npx --yes --package="github:databricks-solutions/lakebase-scm-utils#v0.2.0" lakebase-doctor. ) (中文(简体) )
然后,在任何会话中,运行:
/consort:start
你的第一次行动. 在一个新的文件夹, /consort:start 带你们走过一个Lakebase-paired项目:一个repo,一个对接的数据库,以及角色代理和指挥的脚手架入其中. 在一个已经拥有 .consort/ 目录( Consort's spec- first, test- 驱动状态), 它会恢复您离开的地方 。 (插件中的指令、技能和 MCP 服务器船; 角色代理 住在您的工程中) .claude/agents/由管弦乐师所产 consort-drive 作为 claude --agent <role>. ) (中文(简体) )
何等为想. 组合驱动循环 /plan -> /design -> /build -> /deploy 并且为你们而停在每个城门上
- 地点 设计门,你审查并批准被冻结的规格:故事和接受标准、命令的测试清单以及DBA的计划;
- 通过 构建,每个循环会写一个失败的测试,使其通过一个活的数据库分支,然后重构;
- 地点 部署 财务报告和审定财务报表 促进 门,你批准释放 和迁移到父级.
没有你,任何东西都无法越过大门.
穿过一个完整的第一个项目. examples/first-project/ 是一个会话的分步走法,安装到第一个被运出特性,使用一个抽样目录应用(StockFlow). 它将复制准备的种子文件 用来从我们那里启动自己的项目 而不是从空白页开始.
它的安装、运行和发送
- 安装时间 : 靴子陷阱从此仓库下载 Consort 工具包, 插件的会话启动钩钩运行
npm ci在插件目录中完成安装其依赖性(从 npm 注册的包) . - 运行时间 : 组合产物角色代理作为
claude --agent <role>进程,并应用策略迁移,在您的 Databricks 工作空间连接上运行对您的 Lakebase 数据库的测试。 它只在你瞄准的项目内运行. - 遥测: 假名使用遥测(默认为1级:从闭合许可列表中抽取出每跑一次的痕量),外加一次性安装信标,只搭载了随机安装的ID,工具包版本和时间戳. 从未发送过免费格式的数据、代码、提示或项目内容。 2级是单独的选入. 全部合同,包括如何关闭(
CONSORT_TELEMETRY=0),属于 电话:(212) 963-105。 。 。 .
其他安装方式
对于Claude代码插件以外的编码代理, install.sh 复制技术树 skills/ 进入每个代理读取的路径,先取出最新的销售技能(最佳操作;跳出下线). 自动探测装置; --tools 超载.
# Auto-detect installed agents, prompt to pick
bash <(curl -sL https://raw.githubusercontent.com/databricks-solutions/consort/main/install.sh)
# Specific targets
./install.sh --tools claude,cursor
# Upload skills into a Databricks workspace for Genie Code
./install.sh --install-to-genie --profile DEFAULT
目标:
- 克劳德代码 (单位:千美元)
.claude/skills/(中文(简体) ) - 光标 (单位:千美元)
.cursor/skills/(中文(简体) ) - 数据砖源代码 (工作空间上传)
- Claude 桌面 / OpenAI 编码 通过MCP显示
.mcp.json(服务器位于apps/mcp-server/,也可以在路径lakebase-mcp-server(中文(简体) ) - OpenAI 创始人 消耗预发光谱
tools/openai-foundry/consort.tools.json
manifest.json 是每种技能及其文件的机器可读索引(由 python3 scripts/skills.py) (中文(简体) ).
或者直接从克隆人那里运行垃圾桶 :
git clone https://github.com/databricks-solutions/consort
cd consort
npm install # the prepare script builds dist/
先决条件
靴子夹入 步骤 0 检查并安装这些 。 仅当医生报告一个缺失时, 才会列出这些 .
工具先决条件
- 节点.js 20+ 页:1
- 数据砖 CLI v1.0.0+,认证到Lakebase启用的工作空间(macOS:
brew install databricks/tap/databricks(中文(简体) ) - Py 3.10+ (计:
scripts/openai-foundry.py以及现场驾驶员的阴道) - GitHub CLI (英语:
gh(中文(简体) ) 认证,供自营运营商设置 - JDK 17岁以上 为飞行道直播路径(CLI本身是自动下载)
见 捐款额 全面现场测试的先决条件和 .env.template.test.config 编号 : .env.local.test.config 模式.
更新现有项目中的工具包
当一个新装箱版本的船, 刷新一个脚手架项目运行对:
- 当知有相.
/consort:start运行consort-check-update(按到一天一次,当有电流时保持沉默,从不阻塞),如果在后方,则会浮出一个通知. 随时检查./scripts/lk consort-check-update(单位:千美元)--force跳过油门. - 获取最新工具包 (那个)
/design, (中文(简体) ),/build等实际运行 :./scripts/lk --warmShim比较了这个项目的固定承诺 即时调整和重新安装在漂流上,所以--warm是犬科的"拉出最新的包"步骤。 (./scripts/lk --rewarm强制重新安装已解决的承诺。 ) - 刷新角色代理定义数字 :
./scripts/lk lakebase-update-agents仅创建项目 种子.claude/agents/(它从未覆盖过一个已经存在的文件),所以一个角色提示的工具包错误修正不会到达一个已经安装过的工程,直到刷新为止. 驱动器在检测出套件版本移动时也会自动刷新代理;自行运行指令以刷新出乐队. 使用--dry-run预览,--keep-local以保留项目编辑代理. - 刷新工作流程命令数字 :
./scripts/lk lakebase-update-commands(单位:千美元).claude/commands/*.md对应; 钩文件未被更改). - 刷新插件 (Claude Code):首先刷新市场缓存,再更新,再重新启动克洛德代码:
市场是新鲜的,没有它claude plugin marketplace update databricks-solutions claude plugin update consort@databricks-solutionsplugin update对比对于repo的僵化观点, 插件版本跟踪每个发布( E).claude-plugin/plugin.json),这是什么plugin update用于检测新版本。 说明:claude plugin install在已安装的插件上是禁用 - 使用update。 。 。 .
这回贷里有什么
consort/定心管弦乐手和每个角色的逻辑:驱动回路、设计/建造路由、大门、实验和钉子、恶味探测和代理记录.skills/consort/代理合同(SKILL.md),八个角色代理提示下agents/及其参考文献。 加上工程卡通技能(software-design-principles, (中文(简体) ),architectural-design-principles, (中文(简体) ),ui-ux-design-principles角色导入,以及销售商Databricks技能(databricks-core, (中文(简体) ),databricks-lakebase) (中文(简体) ).templates/页:1.consort/靴子和项目层面.claude/commands一个脚手架项目携带.apps/mcp-server/一个单一的MCP服务器,将工具表面暴露于MCP可胜任的代理(Claude Desktop, OpenAI Codex, Cursor-via-MCP, Genie Code).tools/openai-foundry/一个预发式的 OpenAI Foundary / Codex 工具 spec, 由同一程序生成apps/mcp-server/tools.ts登记.tests/病毒BDD测试. 湖基的活路 跳过干净的当LAKEBASE_TEST_*env vars没有设定.
一个脚手架项目保持其状态 .consort/ (单位:千美元)features/, (中文(简体) ), experiments/, (中文(简体) ), spikes/, (中文(简体) ), cycles/, (中文(简体) ), workflow-state.json, (中文(简体) ), smells.json),其中管弦乐器读作并作曲作为循环运行.
技能
商船本身的技巧 加上工程能力 其作用进口.
consort自我保护:/design财务报告和审定财务报表/build车道,角色代理,和大门.software-design-principlesSOLID, DRY, 清洁代码, 分层结构, 交叉关注, NFRs. 由角色导入.architectural-design-principles系统级能克:分层架构,端口和适配器,十二因子,进化架构和数据库设计.ui-ux-design-principlesuX设计师的经验级Conon 和任何用户建构.- 供应商
databricks-core财务报告和审定财务报表databricks-lakebase只读镜像databricks/devhub(单位:千美元)databricks postgresCLI表面). 刷新为npm run sync:devhub(CI通过电子邮件核对)npm run check:devhub) (中文(简体) ).
国 家 质 量
Bins是Consort的指令表面外加几个项目-生命周期帮助. 运行任意 --help。 。 。 .
consort-drive定型管弦乐团:在设计/建造/部署/促进阶段的路线,培养角色代理,并守住大门。 这个consort-*家庭(-intake, (中文(简体) ),-cycle, (中文(简体) ),-experiment, (中文(简体) ),-spike, (中文(简体) ),-deploy, (中文(简体) ),-approve-gate, (中文(简体) ),-gate-conformance, (中文(简体) ),-next, (中文(简体) ),-test-list, (中文(简体) ),-human-proxy.)是其基石.lakebase-create-project端到端的Lakebase-paired项目靴子 同时也是脚手架 Consors 命令.lakebase-adopt-consort在现有Lakebase-paire项目中添加Consor.lakebase-feature-status报告每个特性在循环中的位置.lakebase-update-commands刷新脚手架项目.claude/commands改为当前版本.lakebase-update-agents刷新脚手架项目.claude/agents当前工具包中的角色定义(因此一个角色即期bugfix会到达一个已存在的项目;驱动器也会在工具包版本的更改上自动更新).lakebase-mcp-serverstdio MCP服务器将工具表面暴露给MCP能代理.
捐款
维护者提交文件(开发设置、构建、测试层次、单密封贡献者规则、释放流量和拉出请求清单) CONTRIBUTING.md。 。 。 .
支助
Databricks不为这个寄存器中的内容提供官方支持. 对于问题或bug,请打开一个 GitHub 问题,团队将尽力提供帮助.
许可证
见 利比里亚。 。 。 .