跳到正文

功能

Project Orchestrator 能做什么

计划、任务、笔记、决策和各有所长的助手,汇集在每个项目自己的一份记忆里。来看看 Project Orchestrator 能为你做些什么。

01

项目,有代码或没有代码都行

每个项目都有自己的计划、任务、笔记和决策。它可以是一个代码库,也可以是没有代码的工作,例如一场活动或一份预算。

  • 在一个页面 Today 里显示你所有的项目:哪些在等你回复,哪些需要接着做,哪些在自己推进。
  • 把多个项目归入一个工作区,共享上下文和目标。
  • 目前没有代码的项目要通过向助手提出请求来创建,应用里的项目表单还不提供这个选项。
幕后细节

项目有一个 profile:software 是会被同步和监视的代码库,work 是没有源码树的文档、计划、任务和笔记。

  • project · create
  • workspace · list
  • project · get_roadmap

看它如何运作

02

目标、计划和任务

目标是你想达到的结果,计划说明如何达到,由任务和步骤组成。PO 会显示哪些已完成、哪些被阻塞、接下来是什么。

  • 跟踪每个步骤、任务和计划的状态,并汇总进度。
  • 显示最长的任务链,让你知道什么决定了完成日期。
  • 同一个计划,可以显示成关系图,也可以显示成分列的看板。
幕后细节

最长的任务链就是关键路径,由依赖图通过 plan(action: "get_critical_path") 计算得出。

  • plan · get_critical_path
  • task · add_dependencies
  • step · update

看它如何运作

03

协同工作的助手

PO 把互不依赖的任务分成一组,每个任务交给各自的助手。默认一次运行四个任务。下一组开始之前,PO 会先检查结果。

  • 实时显示哪些任务已经开始,哪些已经完成。
  • 随时可以停止一次运行,并保留带状态的历史运行列表。
  • 按计划时间或在某件事发生时启动计划,无需有人在场。
幕后细节

plan(action: "run") 在项目文件夹中,于独立的 git 分支上启动执行器。构建检查适用于 Rust、Node 和 Go 项目。

  • plan · get_waves
  • plan · run
  • plan · run_status

看它如何运作

04

笔记和决策

笔记和决策属于你的项目、任务和文件。每一条都有状态(有效、需复查、已过时或已作废),助手因此知道该信任什么。

  • 把决策连同理由和影响范围一起保存,内容变化时再替换。
  • 按含义查找笔记,不只是匹配原词,并列出需要复查的笔记。
  • 提案会在决定之前,把一项改动摆出来供审阅。
幕后细节

笔记和决策是 Neo4j 图谱中的节点。一起使用的笔记通过越用越强的突触(synapse)相连,搜索会顺着这些连线进行。

  • note · search_semantic
  • decision · add_affects
  • note · get_needing_review

看它如何运作

05

文档

文档归在某个项目下。原始文件留在你的电脑上,PO 把文字切成段落,并记住每段的来源。

  • 把文件上传到项目,之后可以再次打开原件,也可以删除。
  • 读取 PDF 和文本文件中的文字。
幕后细节

原件存放在本地磁盘,以 SHA-256 作为地址。文字被切成块,并保留它在原文中的位置。

看它如何运作

06

专精的助手

角色(persona)是专精于你工作某一领域的助手。技能是一组相关的笔记,话题出现时助手会自行启用。

  • 为任务挑选合适的角色。
  • 角色可以为它的任务设定时间上限、成本上限和所用的模型。
  • 技能会从萌芽变为活跃,30 天不用则转为休眠。技能可以导出和导入。
幕后细节

技能从笔记聚类中检测得出(Louvain 社区检测),每个技能都有能量值和凝聚度分数。角色构建器提供基于代码的模式和手动模式。

  • persona · get
  • skill · activate
  • skill · export

看它如何运作

07

可重复的流程

流程(protocol)有起点、若干步骤和终点。助手按顺序执行,每次运行都会被记录。

  • 定义各个步骤,以及什么条件让一次运行从一步进入下一步,然后启动并跟进一次运行。
  • 把流程关联到一项技能,这样技能适用时它就会启动。
  • 一次运行可以先等人审阅,再继续往下走。
幕后细节

流程是一个有限状态机:起始状态、中间状态和终止状态,以及由触发器引发的转换。plan-runner-reviewed 增加了一个 awaiting_review 状态。

  • protocol · add_state
  • protocol · start_run
  • protocol · link_to_skill

看它如何运作

08

共享,须经你同意

每个项目都有共享策略:手动、建议或自动。在手动模式下,没有你的批准,什么都不会发出,逐条笔记审批。

  • 另一个 PO 收到的副本会在设定时间后失效,所有者可以收回。
  • 密码等机密信息保存在保险库里。助手只能在限定范围和时间内访问。
  • 早期版本:批准步骤、失效和收回已经具备,PO 实例之间的交换仍在完善中。
幕后细节

每个实例用 Ed25519 密钥和 did:key 标识符对发出的内容签名。收回是一个带签名的墓碑记录。

  • sharing · set_policy
  • sharing · set_consent
  • sharing · retract

看它如何运作

面向开发者

PO 也能读懂你的代码

PO 把每个代码仓库变成由文件、函数、类型和调用组成的图谱,能回答谁调用了某个函数、一次改动会影响什么。每个概念都是 Claude Code、Cursor 或任何 MCP 客户端可用的工具。

幕后细节
  • 解析 Rust、TypeScript、Python、Go、Java、C 和 C++、Ruby、PHP、Kotlin、Swift、Scala、Zig、Dart 等语言。
  • 通过 Meilisearch 搜索代码,范围可以是一个项目,也可以是整个工作区。
  • 通过 mcp_federation 连接其他 MCP 服务器。

Tree-sitter 把代码解析进 Neo4j 图谱,文件监视器会在你编辑时保持同步。

  • code · get_call_graph
  • code · analyze_impact
  • code · find_references
  • mcp_federation · list

开始使用

给你的 AI 助手一份记忆和一个计划

安装 orchestrator,通过 MCP 连接 Claude Code,让第一个助手在动笔之前先读懂你的项目。

或者从终端开始

brew install this-rs/tap/project-orchestrator