HackubatorLLC/crescendo-agent-template

# Crescendo **一个用于 [Antigravity](https://github.com/google-deepmind/antigravity) 的多 agent 编排框架。** Crescendo 可以在任何领域横向扩展 AI 工作。Coordinator Agent (**Maestro**) 会分派并行的 Subagent —— 每个 agent 都隔离在其自己的 workspace 中，并专注于特定的角色 —— 然后通过自动化的 quality gate 和矛盾检测来合并它们的工作。一个专门的 Scribe Agent (**Score**) 会同步运行，维护一份取证日志。同样的编排引擎支持软件工程、法律分析、营销活动、学术研究和本地化。 ## 快速开始 ### 1. 克隆模板 ``` gh repo create my-project --template /crescendo-agent-template --private --clone cd my-project ``` ### 2. 验证基础设施 ``` # Windows just preflight # macOS / Linux python3 conductor/bin/preflight_check.py ``` 这会检查：外部工具、核心文件、conductor 脚本 (9/9)、领域 profile 和打包的 skill (9/9)。在继续之前，请修复所有 ❌ 项目。 ### 3. 放入项目文件 将你的项目需求放在项目根目录的 `input/` 文件夹中： ``` my-project/ ├── input/ ← Drop files here │ ├── my-prd.md # Product requirements │ ├── architecture.png # System diagrams │ └── constraints.md # Regulatory/compliance rules └── ... ``` 然后对它们进行清理： ``` just sanitize-inputs ``` ### 4. 启动 Maestro 打开 **Antigravity** 并将此项目设置为活动工作区。然后输入： Maestro 将会： 1. 提示你**选择一个领域 profile**（工程、法律、营销、研究或本地化） 2. 解析你清理后的输入 3. 将工作分解为 track 和 task 4. 提交一份**起飞前简报**供你审批（agent 数量、配额估算、commit 范围、自主级别） 5. 一旦你批准，将在并行阶段分派 Score (Scribe) 和领域 agent ### 5. 监控与恢复 ``` just git-status-condutree # View all agent worktrees ``` 如果运行因配额限制而暂停，请开启新会话并输入：*"Resume Crescendo run."*。Maestro 会读取 `orchestration_state.json` 并从中断的地方继续。 ## 前置条件 | Tool | 必需 | 安装 | 备注 | |------|----------|---------|-------| | git | ✅ | [git-scm.com](https://git-scm.com) | | | Python 3.10+ | ✅ | [python.org](https://python.org) | 运行 conductor 脚本 | | just | ✅ | [just.systems](https://just.systems/man/en/installation.html) | 任务运行器 | | Antigravity | ✅ | [Google Antigravity](https://github.com/google-deepmind/antigravity) | AI 编排平台 | | gh (GitHub CLI) | 可选 | [cli.github.com](https://cli.github.com) | 通过 GitHub Issues 进行 HITL 所需 | ## 领域 Profile | Profile | 领域 | 角色 | 自主性 | 聚合方式 | 数据分类 | |---------|--------|-------|----------|-------------|-------------------| | `engineering.json` | 软件工程 | 6 | 完全 | git_merge | internal | | `legal.json` | 法律分析 | 9 | 检查点 | document_assembly | confidential | | `marketing.json` | 营销/内容 | 8 | 完全 | editorial_merge | public | | `research.json` | 学术研究 | 11 | 完全 | matrix_assembly | internal | | `localization.json` | 国际化 | 16 | 完全 | matrix_assembly | internal | Maestro 还可以根据项目需求**动态创建新角色** —— profile 定义的是初始名册，而不是硬性限制。新角色遵循各个领域的主题命名约定进行命名。 ## 包含内容 ``` crescendo-agent-template/ ← Fully self-contained ├── README.md # This file ├── LICENSE # Apache License, Version 2.0 ├── NOTICE # Required attribution notices (preserved in derivatives) ├── CRESCENDO.md # Full guide, architecture, AI ingestion instructions ├── GEMINI.md # 43 behavioral directives for Maestro ├── justfile # 8 automation commands (preflight, sanitize, inspect, poll, etc.) ├── .agents/ # Workspace-level AI config (auto-discovered) │ ├── AGENTS.md # Coordinator bootstrap identity + command table │ └── skills/ # 9 packaged skills (zero external dependencies) │ ├── using-git-worktrees/ # Worktree isolation protocol │ ├── conductor-worktree-hitl/ # Parallel execution + HITL via GitHub Issues │ ├── crescendo-init/ # Project bootstrapper │ ├── conductor-setup/ # Conductor scaffolding │ ├── conductor-implement/ # Track execution engine │ ├── conductor-newTrack/ # Track creation │ ├── conductor-review/ # Code review protocol │ ├── conductor-status/ # Progress dashboard │ └── conductor-revert/ # Git-aware revert assistant ├── input/ # Drop project files here ├── .worktrees/ # Agent workspaces (created at runtime) └── conductor/ # Orchestration brain ├── bin/ # 9 scripts │ ├── preflight_check.py # Infrastructure validator │ ├── orchestration_state.py # State machine (crash recovery, resume) │ ├── run_deterministic_gates.py # Quality gates (tests, lint, scope) │ ├── cross_validate_outputs.py # Contradiction detection │ ├── sanitize_inputs.py # Input sanitization │ └── ... # (4 more: git status, inspector, GHI tools) ├── profiles/ # 5 domain configurations ├── schemas/ # Claims JSON schema (EAV format) ├── templates/ # Setup templates (style guides) └── workflow.md # Execution protocols (239 lines) ``` ## 核心概念 | 概念 | 摘要 | 详情 | |---------|---------|---------| | **Profiles** | 针对特定领域的配置（角色、gate、自主性） | [CRESCENDO.md §5](CRESCENDO.md#5-domain-profiles) | | **43 条指令** | Maestro 的行为规则 | [CRESCENDO.md §6](CRESCENDO.md#6-the-43-directives-geminimd) | | **Scribe Agent** | 必需的观察者 —— 每次运行的取证日志 | [CRESCENDO.md §6](CRESCENDO.md#6-the-43-directives-geminimd) (指令 43) | | **方法验证** | Agent 在编码前提交计划 —— 尽早发现冲突 | [CRESCENDO.md §6](CRESCENDO.md#6-the-43-directives-geminimd) (指令 37) | | **HITL 问题** | Agent 将问题发布到 GitHub Issues 以寻求人工解答 | [CRESCENDO.md §6](CRESCENDO.md#6-the-43-directives-geminimd) (指令 39) | | **Quality Gate** | 合并前的确定性 + 启发式检查 | [CRESCENDO.md §7](CRESCENDO.md#7-quality-gates) | | **自主级别** | 完全 / 检查点 / 监督 | [CRESCENDO.md §8](CRESCENDO.md#8-autonomy-system) | | **配额恢复** | 三层系统（估算 → 等待 → 停止） | [CRESCENDO.md §10](CRESCENDO.md#10-quota-recovery-system) | | **矛盾检测** | 基于声明 (EAV) + 文本提取 | [CRESCENDO.md §14](CRESCENDO.md#14-claims--contradiction-detection) | | **自包含** | 附带所有 skill，零 plugin 依赖 | [CRESCENDO.md §18](CRESCENDO.md#18-self-contained-architecture) | | **AI 摄入** | 未来的 AI 应如何读取此系统 | [CRESCENDO.md §19](CRESCENDO.md#19-for-future-ais-how-to-ingest-this-document) | ## 文档 | 文档 | 目的 | |----------|---------| | [CRESCENDO.md](CRESCENDO.md) | **完整指南** —— 架构、用法、profile，包含全部 20 个章节 | | [GEMINI.md](GEMINI.md) | Maestro 必须遵循的 43 条指令 | | [conductor/workflow.md](conductor/workflow.md) | 执行协议、gate 规则、聚合策略 | | [conductor/profiles/](conductor/profiles/) | 针对特定领域的 JSON 配置 | | [conductor/schemas/claims.schema.json](conductor/schemas/claims.schema.json) | 用于矛盾检测的 EAV 声明格式 | ## 许可证 Copyright 2026 Hackubator LLC Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the [LICENSE](LICENSE) file for the full license text and the [NOTICE](NOTICE) file for required attribution notices.

标签：Git版本控制, SOC Prime, 人工智能, 多智能体编排, 开发工具, 用户模式Hook绕过, 逆向工具