
Symphony支持5大项目管理工具Linear、GitHub Issues、Jira、Asana、GitLab集成详解【免费下载链接】symphonySymphony turns project work into isolated, autonomous implementation runs, allowing teams to manage work instead of supervising coding agents.项目地址: https://gitcode.com/gh_mirrors/symphony7/symphonySymphony 是一款 AI 智能体编排引擎它支持 Linear、GitHub Issues、Jira、Asana、GitLab 五大项目管理工具集成能把看板中的任务自动转化为隔离、自主的执行运行run让团队从盯着编码智能体干活升级为只管理工作项。本文带你快速搞懂每种集成的配置要点、内置 Agent 工具和安全设计。Symphony 是什么从看管智能体到管理工作Symphony 的工作逻辑非常直白共四步轮询配置好的 Issue 追踪工具即本项目说的轨道拉取处于活跃状态的工作项为每个工作项创建独立工作区智能体只能在自己的目录里活动在工作区内启动编码智能体Codex App Server 模式下发来自WORKFLOW.md的工作流提示词持续跟进直到任务到达交接状态如Human Review期间失败会指数退避重试上图是 Symphony 运行时的状态面板顶部显示并发智能体数量、Token 吞吐量和限流状态下方列出每个 Issue 所处阶段Todo、In Progress、Rework与最近事件让多任务并发运行完全可观测。五大轨道集成速览对比表Symphony 通过统一的适配器边界见 tracker.ex支持五种追踪工具只需在配置中切换tracker.kind即可换轨道项目管理工具tracker.kind默认状态语义内置 Agent 工具默认凭据环境变量 Linearlinear自定义Todo / In Progress / Rework…linear_graphqlLINEAR_API_KEY GitHub Issuesgithubopen→closedgithub_apiGITHUB_TOKEN Jira Cloudjira自定义 Jira 状态名jira_restJIRA_BASE_URL、JIRA_EMAIL、JIRA_API_TOKEN✅ Asanaasana项目分区Section名即状态asana_apiASANA_PAT GitLabgitlabopened→closedgitlab_apiGITLAB_PAT所有适配器都会把各自平台的原始数据标题、描述、优先级、标签、阻塞关系等归一化为统一的 Issue 模型issue.ex调度器不感知平台差异——这就是换一行配置就能换工具的原因。Linear 集成全流程状态协作Linear 是 Symphony 的原生主场仓库自带的 WORKFLOW.md 就是基于 Linear 编写的完整工作流示例。配置要点源码见 linear/adapter.ex必填project_slug在项目页面右键复制 URL 即可获得API Key 默认读取LINEAR_API_KEY环境变量也支持$VAR引用可选assignee按负责人过滤任务Todo状态的任务若存在未完成的阻塞项适配器会自动判定为不可派发工作流示例Symphony 的参考工作流把任务状态设计为Todo → In Progress → Human Review → Merging → Done的完整闭环智能体还内置了一条持久化工作台评论Codex Workpad作为进度真相源。智能体通过linear_graphql工具直接在宿主机侧执行 Linear GraphQL 操作改状态、写评论、贴 PR 链接无需二次登录。GitHub Issues 集成把仓库 Issue 变成自主开发GitHub 集成适合代码和 Issue 都在 GitHub的团队源码见 github/adapter.ex必填tracker.provider.repo格式为owner/repo活跃状态只能写open终态写closed调度器会严格校验Issue 号会被规范化为GH-编号的工作区标识PR 不会被当作 Issue 派发避免了任务卡和代码评审两种对象的混淆github_api工具允许智能体携带相对路径的 REST 请求在宿主机侧执行Token 权限边界由你配置的 GitHub Token 本身决定。Jira Cloud 集成企业级状态与阻塞感知Jira 集成面向企业团队源码见 jira/adapter.ex必填project_key并配合base_url、email、api_token三项认证均有默认环境变量active_states/terminal_states必须显式写出你项目里真实的 Jira 状态名阻塞感知是亮点Jira 的Blocks链接会填充到 Issue 的blocked_by字段处于new状态分类的任务会等待所有阻塞项进入终态后才被派发进行中的任务则继续运行jira_rest工具以 Basic Auth 转发/rest/api/3/请求智能体可以完成状态流转、写评论、读字段等全套操作。Asana 集成用分区名当作任务状态Asana 没有状态机概念Symphony 的巧妙处理是把项目的分区Section名当作状态源码见 asana/adapter.ex必填project_gid指定项目你在 Asana 里建几个分区比如Todo、In Progress、Done就把分区名填进active_states和terminal_statesASANA_PAT提供个人访问令牌asana_api工具执行 Asana REST 请求刷新任务时被删除或移出项目的任务会被自动忽略不会造成调度异常。GitLab 集成自建团队的可靠选择GitLab 集成适合代码托管在自托管 GitLab 的团队源码见 gitlab/adapter.ex必填project_pathapi_url指向你的 GitLab 实例默认官方地址可改成自建状态固定为opened→closedIssue 标识规范化为GL-IIDGITLAB_PAT令牌默认从环境变量读取gitlab_api工具转发原始 GitLab REST 请求同样支持宿主机侧认证。如何切换轨道WORKFLOW.md 里的一行配置切换项目管理工具的核心就是改 WORKFLOW.md 的 YAML front matter 中的tracker段。以 Linear 为例tracker: kind: linear # 改成 github / jira / asana / gitlab 即可换轨道 provider: project_slug: your-project active_states: - Todo - In Progress terminal_states: - Done - Canceled三个实用细节热加载WORKFLOW.md被修改后 Symphony 会自动重新加载无需重启服务加载失败时会保留上一份可用配置继续运行密钥用$VAR引用例如api_key: $LINEAR_API_KEY这样令牌既不出现在仓库文件里也不会泄露给智能体子进程标签过滤required_labels可要求任务必须带某些标签才会被派发方便只让 Symphony 处理特定任务安全设计智能体看不到追踪工具令牌这是五大集成共有的安全模型值得单独强调追踪工具的凭据保留在 Symphony 宿主机进程内智能体要写 Issue改状态、评论、贴 PR时调用的是各适配器暴露的原生工具linear_graphql、github_api、jira_rest、asana_api、gitlab_api由 Symphony 代为执行启动 Codex 子进程前Symphony 会摘除声明的令牌环境变量——智能体不需要、也拿不到第二个追踪工具登录换句话说读数据走适配器写数据走托管工具令牌全程不出宿主机。快速上手三步走第一步获取代码git clone https://gitcode.com/gh_mirrors/symphony7/symphony cd symphony/elixir第二步准备工作流文件把仓库里的 WORKFLOW.md 复制到你自己的代码库按上表修改tracker.kind和tracker.provider配置并在工作区after_create钩子里git clone你的项目。第三步配置令牌并启动以 Linear 为例设置LINEAR_API_KEY环境变量后mise install mise exec -- mix setup mise exec -- mix build mise exec -- ./bin/symphony ./WORKFLOW.md加上--port参数还能开启 LiveView 仪表盘和 JSON API实时查看每个 Issue 的运行状态截图见文首状态面板。常见问题Q一次能同时接入多个项目管理工具吗不能。tracker.kind一次只选择一个适配器但热加载机制让你随时切换。Q我团队用哪一套工作流状态GitHub / GitLab 只有开/关两态流程简单Linear / Jira / Asana 支持自定义状态推荐复刻参考工作流的Todo → In Progress → Human Review → Merging → Done五段式人工只在Human Review和Merging两个节点介入。Q令牌泄露了怎么办因为令牌只存在于宿主机环境变量、且以$VAR间接引用轮换令牌只需更新环境变量并重启 Symphony不需要改任何仓库文件。总结Symphony 的五大项目管理工具集成遵循统一的设计哲学归一化的 Issue 模型 适配器专属工具 宿主机侧认证。无论你是 Linear 重度用户、GitHub 一体化团队、Jira 企业、Asana 协作小组还是自托管 GitLab 团队只需换一行tracker.kind配置就能让 AI 智能体在你的看板里自动开工。团队真正要做的只剩下定义工作流和验收结果。【免费下载链接】symphonySymphony turns project work into isolated, autonomous implementation runs, allowing teams to manage work instead of supervising coding agents.项目地址: https://gitcode.com/gh_mirrors/symphony7/symphony创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考