协作任务联动
目的
定义任务、文档、PR、CI、发布、事故和 Lark/Slack 消息之间如何联动。联动的关键是让每个系统保留自己的事实来源，同时互相可追溯。
系统事实来源
| 事实 | 系统 |
|---|---|
| 工作项和优先级 | Linear/Jira/GitHub Issues |
| 代码和 PR | GitHub/GitLab |
| CI 结果 | GitHub Actions/GitLab CI |
| 产品和会议文档 | Notion/Lark Docs/Wiki |
| 发布记录 | GitHub release / internal release record |
| 事故记录 | Incident doc + Linear/Jira action items |
| 运行日志和指标 | Sentry/Grafana/Datadog |
三角色事实来源
| 角色 | 主要事实来源 | 不接受什么 |
|---|---|---|
| 产品负责人 | 任务、PRD、验收记录、发布反馈 | 只在群里说“产品同意了” |
| 技术负责人 | PR、CI、架构文档、发布记录 | 只靠口头说“风险不大” |
| 平台 / 资深工程师 | CI、部署系统、监控、日志、runbook | 只靠个人收藏链接和本地脚本 |
标准链接规则
| 对象 | 必须链接 |
|---|---|
| Linear issue | spec、PR、release、incident action |
| PR | Linear issue、测试证据、风险、rollback |
| RFC/ADR | 相关 issue、PR、模块 |
| Release | PRs、migration、dashboard、rollback |
| Incident | alert、timeline、PR fix、action items |
任务到 PR 流程
Linear issue
-> branch: HYP-123-short-title
-> PR title: HYP-123: short title
-> PR body links issue and evidence
-> CI checks attach status
-> merge updates issue
-> release links PR
三角色工具流
| 流转 | 工具 | 产品负责人 | 技术负责人 | 平台 / 资深工程师 | 组员 |
|---|---|---|---|---|---|
| 需求 -> 任务 | Linear/Jira | 写用户、问题、优先级 | 标风险 | 看执行条件 | 补背景 |
| 任务 -> PR | GitHub/GitLab | 回答产品问题 | 指定 reviewer | 确认检查命令 | 实现和提 PR |
| PR -> 发布 | CI/CD + checklist | 验收用户可见变化 | 确认风险和回滚 | 准备发布和监控 | 修复问题 |
| 发布 -> 反馈 | 任务卡 + dashboard | 看用户反馈 | 看错误和技术债 | 看告警和日志 | 创建后续 action |
详细步骤见 16-三角色协作流程-three-role-collaboration-flow.md。
Lark/Slack 联动
Lark/Slack 适合通知和协作：
| 事件 | 消息内容 |
|---|---|
| PR ready | PR 链接、owner、reviewer、risk |
| Release started | version、owner、migration、dashboard |
| Release completed | smoke、error rate、rollback |
| Incident opened | severity、commander、channel/doc |
| Blocked | task、blocker、需要谁决策 |
| Approval requested | action、risk、evidence、decision link |
不要把 Lark/Slack 消息当作唯一记录。每条消息都应链接回事实系统。
后续 Agent 协作平台联动
这一节在人类任务、PR、发布和事故联动稳定后再看。
Issue / Task
-> Control Plane Task
-> Agent Run
-> RunMessage timeline
-> Artifact / Handoff
-> Draft PR
-> Approval
-> Release
Agent 产生的每个 artifact 都必须能追溯：
- 来自哪个 task。
- 哪个 agent profile。
- 哪个 runtime。
- 改了哪个 repo/scope。
- 通过哪些测试。
- 哪个人批准。
自动化建议
| 自动化 | 实现 |
|---|---|
| PR 创建后更新 issue | GitHub integration / webhook |
| CI 失败通知 | GitHub Actions -> Lark/Slack |
| Release 通知 | GitHub Actions -> Lark bot |
| Incident action 创建 | Lark/Slack command -> Linear/Jira |
| Agent run blocked | 后续 Agent control plane -> Lark interactive card |
| Approval 决策 | Lark action -> backend API -> audit log |
后续 Agent 就绪要求
Agent 必须使用这些链接规则。它不能只说“完成了”，必须产出：
- 关联 task。
- 关联 PR 或 patch。
- 关联测试证据。
- 关联 artifact。
- 关联 approval 或 reviewer。
下一步阅读
读完或填完这份文档后，通常继续看：
- 16-三角色协作流程-three-role-collaboration-flow.md：链接规则明确后，继续看三角色如何按流程协作。