benxu001/agentic-linear-orchestration-framework

# agentic-linear-orchestration-framework 一个原生的 Linear 多 agent 编排器，专为 Claude Code 打造，提取自真实的已上线项目。 ## 这是什么 这是一个可实际运作的框架，利用 Claude Code 以高度自治的方式，端到端地交付 Linear backlog 中的 issue。你在顶层驱动编排器会话；编排器负责挑选 issue，在 git worktree 中生成 implementer 子 agent，在每个 PR 开启时生成 reviewer 子 agent，并在 issue 的级别允许时自动合并干净的工作。你只需在需要人为判断的事务上（如页面路由、细节优化、任何跨切面的问题）保持参与；编排器会处理围绕这些事务的机械化流水线。 该框架在 [DropLog](case-studies/README.md) 的生产实践中开发，这是一个个人项目，也是此处包含的每一条规则、每一个陷阱以及每一个自动合并决策的测试床。每一项硬性规则背后都有一个真实的故障事件——有关详细分析，请参阅 [`case-studies/`](case-studies/)。 ## 30 秒心智模型 ``` operator -> orchestrator picks Linear issue -> spawn implementer subagent (worktree-isolated) -> reads issue, branches, implements, verifies, pushes PR -> flips Linear In Progress -> In Review -> returns structured verdict -> spawn reviewer subagent (read-only) -> applies PR Review Standard, returns 3-bucket verdict -> orchestrator applies the auto-merge gate -> auto-merge if reviewer is clean and tier allows -> otherwise ping operator -> orchestrator logs the run for model-fitness tracking ``` 完整图景请参阅 [ARCHITECTURE.md](ARCHITECTURE.md)。 ## 你将获得什么 - **多 agent 生成模式**，适用于 Claude Code 的子 agent 系统，包括针对项目级 agent 发现限制的应对方案（[`framework/memory/subagent-spawn-pattern.md`](framework/memory/subagent-spawn-pattern.md)）。 - **带有层级模型的自动合并闸门**，可区分机械化工作（可自动合并）与需要判断的事务（需要操作员介入）。参见 [`framework/.claude/orchestration/policy.md`](framework/.claude/orchestration/policy.md) 第 3 和第 5 节。 - **Implementer + reviewer 子 agent 规范**，包含完整的工作流、结论格式和升级规则。 - **Canon / memory / decisions 知识分层** —— 明确各个层面的用途及更新方式。 - 来自生产实践的**真实故障模式库**：工作区泄漏、分类器阻塞、隐秘的 SDK 陷阱、RLS 覆盖遗漏、OAuth 归属问题——每一项都包含具体事件、由此得出的规则以及恢复程序。 无论你是正在交付业余项目的独立开发者，还是正在寻找成熟模式以供借鉴的团队成员，它都非常有用。诚实的范围界定：交付的框架是基于 Linear + Claude Code 编写的；要适应其他任务追踪器或测试框架是一项轮廓清晰的工作——有关耦合点以及抽象层应放置在何处，请参见 [LIMITATIONS.md](LIMITATIONS.md)。 ## 快速开始 `framework/` 目录是一个可直接复制使用的模板。要在新项目中使用它： 1. 将 `framework/` 的内容复制到你的项目根目录。 2. 编辑 `AGENTS.md`、`RETRIEVAL.md` 以及 `.claude/agents/` 中的 agent 规范，将 `{ISSUE_PREFIX}`、`{PROJECT_NAME}`、`{STACK}` 等占位符替换为你的具体信息。 3. 如果你使用 Linear，请设置一个专门的 agent OAuth 用户（参见 [case-studies/03-linear-agent-oauth/](case-studies/03-linear-agent-oauth/) ），并将四个 `LINEAR_AGENT_*` 环境变量添加到你项目的 `.env.example` 中。 4. 在项目根目录中打开一个 Claude Code 会话。Canon 将通过 `CLAUDE.md` 的 `@` 导入自动加载。 5. 阅读 [ARCHITECTURE.md](ARCHITECTURE.md) 了解角色契约和自动合并闸门，然后端到端地走通一个 issue，以确认该流水线在你的环境中能够正常工作。 ## 仓库布局 ``` . +-- README.md this file +-- ARCHITECTURE.md knowledge layers + roles + auto-merge gate +-- LIMITATIONS.md coupling points + honest scope +-- CHANGELOG.md +-- LICENSE MIT +-- framework/ the drop-in template | +-- AGENTS.md | +-- CLAUDE.md | +-- RETRIEVAL.md | +-- .claude/ | | +-- orchestration/ policy + decisions log + how-to | | +-- agents/ implementer + reviewer role specs | | +-- settings.json SubagentStop hook | +-- memory/ index + seed gotcha files +-- case-studies/ anonymized incidents from the originating project | +-- README.md | +-- 01-model-escalation-tracking/ | +-- 02-orchestrator-in-session-fix/ | +-- 03-linear-agent-oauth/ | +-- 04-stack-gotchas/ +-- diagrams/ Mermaid architecture + workflow + gate diagrams ``` ## 许可证 MIT。详见 [LICENSE](LICENSE)。

标签：Claude Code, MITM代理, SOC Prime, 多智能体编排, 开发工具