来源

来源是对单项工作的记录：包括任务、计划、计划任务或工作包。它解答了变更合并后仍需回答的问题：该工作源自何处、由谁提出、归谁所有、决策人与决策依据是什么，以及最终交付了什么。

Coroid会根据工作在Factory中流转时产生的各类信息来生成来源记录：启动该工作的聊天对话或请求、人员审批通过的文档、做出的相关决策，以及用于交付的拉取请求和提交记录。你可在门户、拉取请求及提交记录中查看同一份记录，负责处理该任务的智能体也会读取该记录。

来源涵盖的内容#

• 来源。启动该工作的源头，并附带指向该源头的链接：聊天对话、Prepare Work审核、新任务请求、导入或通过Webhook触发的工单、钩子、定时任务、MCP客户端、API、发现结果或报告，或是上级计划或任务。
• 需求提出方与所有者。提出该工作需求的人员，以及当前该工作的所有者。若工作是通过服务账号提交，或来自组织外部人员（如GitHub工单的作者），来源中会明确标注对应的账号或人员名称。Coroid绝不会自行填写其无法确定的成员信息。
• 决策。审批、变更请求、启动、暂停、重试、合并、覆盖及所有权变更等操作，均会标注执行人、时间及给出的理由。
• 讨论。影响该工作的人员留言：包括源自初始对话的简短摘录，以及对相关文档的反馈，每条留言都会标注作者及对应链接。
• 交付。包括拉取请求、提交记录、质量审核结果、审核决策以及相关凭证。

归属于某个计划的任务会沿用该计划的起因和请求方信息。其来源记录还会展示相关脉络：包括该任务、对应的计划及工作包，以及触发它们的聊天记录或请求内容。

先查看摘要#

每个来源视图均以摘要形式呈现，方便您快速了解工作的用途及负责人：

• 意图：简要说明该工作的内容与目的。其内容源自已批准的意图说明、规格说明、原始请求，或是任务或计划描述。下方会标注内容的来源。
• 请求方：提出该工作请求的人员、服务账号或外部人员。
• 所有者：当前负责该工作的人员。即最近接收该工作的人员、任务分配对象、发起该工作的对话所有者，或是请求方。
• 审批人：即批准其意图、规格说明及实施方案的人员，以及对应的获批角色。
• 关键决策：最多展示最近五条人员做出的决策及其对应原因。

列出的审批人均为人工参与审批的人员。Coroid自动记录的审批信息不会纳入此处；详情请参阅自动决策。

查看位置#

在门户中#

在Factory中打开对应任务或计划，展开其来源板块。在摘要下方即可看到以下内容：

• 来源：即工作的起始出处，附有指向对应聊天记录、请求、议题或报告的链接。
• 溯源信息：指任务所属的计划和工作包，仅当任务隶属于某个计划时才会存在。
• 决策记录：按时间从早到晚排列，每条记录均标注对应原因。系统会展示最新的八条记录，点击即可查看全部历史记录。
• 讨论内容：对任务形成产生影响的消息，按时间从新到旧排列。
• 交付：包含合并请求的Pull Request、相关提交、QA判定结果、审核记录以及佐证材料。

精简版内容会显示在任务的“详情”标签页以及计划的推广审核页面中，点击即可查看完整的来源记录。

访问权限与工作内容绑定：查看任务的来源记录需具备对应项目的读取权限，而计划的来源记录则和计划本身一样，可在整个组织内查看。

在Pull Request中#

每个由 pull request Coroid 创建的任务、计划或发布 pull request 都包含来源章节，该章节开篇会呈现相同的摘要：明确工作意图、具体内容、需求提出方、所有者、审批人以及关键决策。随后会列出工作起源及相关链接，接着是工作脉络、相关决策、交付成果，最后还有一个可在 Coroid 中打开对应工作的链接。

Coroid 会在该章节周边补充其他内容：包括变更摘要、指向任务及审核证据的链接、验收标准，以及质量保障和审核状态。

Coroid 仅负责标注有隐藏注释的章节。例如当它对 pull request 进行重构更新时，会替换这些章节，同时完整保留你或审核人员撰写的其余内容。若历史记录过长无法全部展示，最先被舍弃的是最早做出的决策，章节中会注明更多信息可在 Coroid 中查看。

发布 pull request 会逐一列出所包含的各 pull request：明确其交付内容、需求提出方以及审批人，并按合并顺序排列。

在提交中#

Coroid 创建的每条提交末尾都会附带标记所属工作内容的尾部信息：

Coroid-Task: 3f6e2b1c-7d4a-4c1e-9b2f-0a8d5e6c7b91
Coroid-Plan: 8a41b7c3-25d0-4f6b-a1e9-6c3d2b7f4e05
Coroid-Requested-By: Maya Lindqvist
Coroid-Origin: prepare_work

根据工作内容的不同，提交还会标注对应的计划任务、工作包、智能体运行记录、补丁或发布版本。请求方尾部信息会显示名称而非电子邮件地址。

Coroid 是其创建的每条提交的提交者。若提交是由个人账号发起，Coroid 也会将其列为共同作者。

Co-authored-by: Coroid <ai@coroid.ai>

Coroid 还会维护每条提交与对应任务或计划的映射关系。当由 Coroid 打开的 pull request 在 GitHub 或 GitLab 中合并时，Coroid 会记录对应的合并或压缩提交信息，避免压缩合并操作导致映射关系丢失。

面向智能体#

每个Agent针对任务的工作记录都会总结其来源：该工作存在的缘由、需求提出方、责任人以及已确定的决策内容。当Agent需要更多信息时，可逐段查看完整的记录。

规格说明仍具有约束力。若来源内容与规格说明不一致，智能体会遵循规格说明，并在报告中注明冲突，而非擅自做决定。人员撰写的信息在智能体读取前会经过 Coroid 的提示词注入过滤机制，被过滤掉的内容不会被传递。

绝不会同步到你的 Git 托管平台的内容#

聊天内容绝不会被写入pull request或提交记录中。拉取请求会包含相关名称、角色、决策、原因及链接。讨论信息仅会显示为消息数量及发送者姓名，并附带指向Coroid中聊天的链接。电子邮件地址不会被记录；人员仅以姓名形式呈现。

仅保留链接#

默认情况下，pull request的来源部分会包含意图段落、关键决策及相关人员给出的原因。组织也可选择仅保留链接的模式。该模式下只会记录请求人、任务所有者、审批人、相关决策以及指向Coroid的链接，而不会包含意图段落、关键决策及所有原因。

若不允许读取产品设计思路的人员能够查看代码库（例如代码库为公开状态），可选择仅保留链接模式。该设置适用于你启用后Coroid所创建或更新的拉取请求。目前暂未提供对应的设置界面。联系我们即可将你的组织设置为仅保留链接模式。

决策及其原因#

Coroid会记录工作推进过程中的各项决策：包括意图、规格说明及计划的审批，资格审核，手动启动、暂停、重试及完成工作，合并与强制合并，关卡覆盖，发布审批，任务所有者或参与人员的变更，以及QA和审核员智能体、协调员的判定结果。

当你审批并启动计划、暂停任务或重新尝试执行任务时，确认环节会要求你填写最多2000字符的可选原因。该原因会连同你的姓名一同存入任务的来源记录中，除非你的组织采用了仅保留链接模式，否则拉取请求中会显示该原因。一句话即可说明清楚：“春季营销活动前客户已提出此项需求”，这比单纯的审批记录能为后续阅读者提供更多信息。强制合并操作本身就需要书面原因，且会以相同方式被记录。

自动决策#

部分决策是代他人记录的，而非由本人作出。计划任务的交付合同会根据已获批的计划自动获批；若无指定人员审批计划，则由计划创建者代为履职。时间线中会将此类决策标记为“自动”，且它们不被视为个人的审批行为。

由智能体作出的决策，例如QA和审核 verdicts以及协调员的判定，会以智能体名称及对应总结的形式呈现。

为正在进行的任务补充上下文#

任务执行期间，无需中断即可向智能体传达相关信息。打开对应任务的“活动”标签页，在实时活动旁选择“添加上下文”，输入不超过2000字符的内容后确认即可。

• 智能体运行时，会在下一次处理时读取你发送的消息；正在等待其他智能体的协调员也会即时读取该消息。
• 若没有智能体正在运行，下一个启动的智能体会读取该消息。

该消息会作为“添加上下文”决策记录到任务的来源中，并标注你的姓名。它不会改变任务的交付要求：若消息内容与规格说明冲突，智能体会反馈该冲突而非自行做决定。若要更改最终结果，需修改规格说明或将任务退回重新处理。

添加上下文功能需要拥有对应任务项目的写入权限。已完成的任务和已取消的任务不支持该功能。

追溯代码对应的工作内容#

你可以从某行代码入手，查找生成该代码的原始工作。门户、智能体、MCP客户端和Git都能帮你定位相关信息。

它为何会出现在这里？#

在任务的代码审核环节，所有涉及现有行的代码块旁都有该按钮。它会查询目标分支上最后一次修改这些行的提交记录，并显示每处修改的来源：

• 由Coroid生成：即对应的任务或计划，包含其意图、请求方和审批方信息、关键决策内容，以及完整的来源链接。
• 由Coroid之外生成：没有任务或计划记录此次变更的原因，因此只能看到作者和日期信息。

若变更新增的文件没有历史行内容，则不会显示该按钮。

通过智能体或MCP客户端操作#

Agent和MCP客户端均通过同一工具提出相同请求。该工具可接收指定文件，若需要还可指定行范围、分支、标签或提交信息。它会返回各行范围对应的最后一次修改提交记录。对于由Coroid发起的提交，该工具还会返回其对应的任务或计划，并总结其来源。该工具名为explain_code。

• 智能体：Coroid的开发者、审核员和协调员智能体在修改或删除用途不明确的代码前都会使用该工具。
• MCP客户端：该工具为只读工具，因此需要使用具备审核员角色且拥有以下范围的权限：mcp.read。它仅在连接可访问的项目中生效，每分钟最多支持30次调用。

借助 Git#

Coroid 生成的每次提交都会在其尾部标注对应的工作信息，因此 Git 也能帮你定位到相关内容：

git blame -L 120,120 src/search/alerts.ts   # the commit that last changed line 120
git log -1 <sha>                            # its Coroid-Task or Coroid-Plan trailer

随后在门户中打开对应任务或计划，即可查看其来源详情：

• 任务：https://client.coroid.ai/factory/task:<task id>?panel=provenance
• 计划：https://client.coroid.ai/factory/<plan id>#provenance

若要查看合并提交或压缩提交的相关信息，请打开其对应的pull request。该提交所属的“来源”板块会提供指向Coroid的链接。

导出来源信息#

该面板顶部设有两个下载按钮。Markdown格式的文件会下载来源摘要内容，其结构同pull request章节一致，包含相关原因说明但不含对话文本。JSON格式的文件则会下载完整的记录，涵盖所有讨论摘录，可供您自行存档或供工具调用。由于JSON文件会收录对话内容，请务必将其设为私密。

未记录来源#

Coroid 会记录该功能推出后创建的工作的来源信息。 更早的工作则会显示此消息，而非显示其起因：

起源未记录。此工作是在Coroid记录来源之前创建的。

当Coroid从过往记录中识别出来源时，比如某个计划的起源对话或对应的报告，面板会将其列为已知来源。此前已记录的决策，比如文档的审批结果，仍会显示；其余内容可能暂未呈现。

标记为“派生”的源信息是根据过往记录重构而来，并非在工作创建时直接采集。

相关#

• 任务
• 计划
• 审核并合并结果
• 聊天助手
• 规格说明
• Coroid 作为 MCP 服务器