试点讨论清单
目的
这份文档回答两个问题：
- 试点落地前，哪些人必须一起讨论？
- 每类工具怎么协作，哪些流程必须在试点里确认？
不要把讨论开成泛泛的共识会。每次讨论都要产出 owner、工具入口、任务链接、检查命令、验收方式或后续 action。
必须参与的人
| 人 / 角色 | 为什么需要 | 讨论重点 | 必须输出 |
|---|---|---|---|
| Sponsor / 业务负责人 | 决定是否允许团队花时间修流程 | 试点项目、边界、优先级、是否接受短期效率下降 | 试点授权和成功标准 |
| Product Owner | 保证做的是正确问题 | 用户问题、优先级、验收、上线反馈 | 功能简报或任务验收标准 |
| Tech Owner | 保证技术方案可维护 | 架构边界、风险路径、review owner、回滚 | 技术风险结论 |
| Ops Owner / 平台负责人 | 保证项目能运行、发布、排障 | 本地环境、CI、发布入口、监控、日志、密钥 | 可执行工具入口 |
| Doc Driver | 保证讨论结果写回文档 | docs/PROJECT.md、试点验收记录、文档修复任务 |
文档更新清单 |
| 新人 / 非核心成员 | 验证文档是否真能被读懂 | 本地试跑、命令是否能复制、缺口在哪里 | 试跑记录 |
| 执行工程师 | 验证流程能不能支持真实开发 | 任务拆分、分支、PR、测试、review | 小任务 PR |
| Reviewer / 模块 owner | 守住代码质量和模块边界 | PR 门禁、模块风险、测试覆盖 | review 结论 |
| QA / 测试负责人 | 高风险或多端项目需要 | 测试环境、测试数据、回归范围、smoke | 测试计划和证据 |
| 设计 / 运营 / 客服代表 | 用户可见变化需要 | 页面状态、文案、通知、反馈入口 | 验收补充和上线反馈入口 |
| 安全 / 合规负责人 | 涉及权限、客户数据、支付、密钥时必须参与 | 权限、审计、数据风险、密钥使用 | 安全 review 结论 |
| 财务 / 商务负责人 | 涉及成本、计费、第三方采购时参与 | 成本、套餐、采购、供应商 SLA | 成本和商务限制 |
小团队不一定每个岗位都有人，但这些视角不能缺。一个人可以兼任多个角色，试点记录里必须写清楚。
哪些地方必须讨论
| 讨论点 | 要问的问题 | 输出写到哪里 |
|---|---|---|
| 试点项目选择 | 为什么选这个项目？风险是否中等？近期是否有真实任务？ | templates/试点验收-pilot-acceptance.md |
| 用户问题 | 用户是谁？当前痛点是什么？为什么现在做？ | templates/功能简报-feature-brief.md |
| Scope | 这次做什么？明确不做什么？ | 任务卡 / 功能简报 |
| 验收标准 | 谁验收？用截图、preview、数据还是日志验收？ | 任务卡 / templates/产品验收-product-acceptance.md |
| 项目入口 | 新人从哪里开始？本地怎么跑？检查命令是什么？ | templates/项目入口-project-index.md |
| 技术风险 | 是否影响架构、数据库、权限、支付、客户数据、第三方依赖？ | RFC / ADR / PR |
| 工具入口 | 任务、PR、CI、文档、发布、监控、日志分别在哪里？ | docs/PROJECT.md |
| 本地开发 | 依赖服务、环境变量、migration、seed、reset 怎么做？ | docs/PROJECT.md |
| PR 和 review | 谁 review？CI 必跑什么？失败谁处理？ | PR 模板 / CODEOWNERS |
| 发布和回滚 | 谁发布？怎么 smoke？怎么 rollback？ | templates/发布检查表-release-checklist.md |
| 监控和反馈 | 上线后看什么 dashboard、日志、告警、用户反馈？ | Runbook / 产品验收记录 |
| 文档维护 | 哪些结论必须写回项目文档？谁负责？ | Doc Driver action |
工具协作流程
整套文档已经定义了工具，但试点时必须确认当前项目的真实工具入口。
| 流程 | 推荐工具 | 需要确认的项目级入口 | 失败信号 |
|---|---|---|---|
| 需求进入 | Linear / Jira / GitHub Issues | 项目任务看板、issue 模板、优先级规则 | 需求只在群聊里 |
| 产品说明 | Notion / Lark Docs / repo docs | PRD、功能简报、设计稿链接 | 做完没人知道验收什么 |
| 设计协作 | Figma / 设计系统 | 设计稿、组件规范、状态说明 | UI 靠口头解释 |
| 代码协作 | GitHub / GitLab | 仓库、分支规则、CODEOWNERS、PR 模板 | PR 找不到 reviewer |
| 自动检查 | GitHub Actions / GitLab CI / Buildkite | required checks、检查命令、失败处理人 | CI 可选或没人看 |
| 本地运行 | Docker Compose / Dev Container / 本地脚本 | 安装、依赖服务、环境变量、migration、seed | 新人只能靠私聊跑起来 |
| 发布 | GitHub Actions / GitLab CI / 发布平台 | 发布入口、权限、Operator、release checklist | 发布靠个人收藏夹 |
| 监控日志 | Sentry / Grafana / Datadog / Loki | dashboard、日志查询、告警规则 | 上线后只等用户报错 |
| 沟通通知 | Lark / Slack | 项目群、发布通知、事故群、机器人 | 群聊替代事实系统 |
| 密钥权限 | 1Password / Vault / 云 Secret Manager | 权限申请、审计、轮换方式 | 密钥出现在文档或群聊 |
工具可以替换，但事实来源不能混乱。任务事实在任务系统，代码事实在 Git 平台，运行事实在监控日志，决策和验收必须回写记录。
讨论会怎么开
会前准备
Doc Driver 提前准备：
- 候选试点项目。
- 当前项目
docs/PROJECT.md是否存在。 - 当前任务看板、仓库、CI、发布、监控、日志入口。
- 一个适合试点的小任务候选。
- 当前已知卡点。
会中只做四件事
| 顺序 | 动作 | 输出 |
|---|---|---|
| 1 | 确认试点项目和边界 | 试点项目、周期、成功标准 |
| 2 | 确认角色 | Sponsor、Product Owner、Tech Owner、Ops Owner、Doc Driver、试跑人 |
| 3 | 确认工具入口 | 任务、文档、代码、CI、发布、监控、日志、沟通群 |
| 4 | 确认试点任务 | scope、验收标准、review、发布或模拟发布方式 |
会后必须留下
- 一个试点任务卡。
- 一份试点验收记录。
- 一个待补的
docs/PROJECT.md或文档修复 PR。 - 一个真实小任务或 bug。
- 明确的下一次检查时间。
需要升级讨论的情况
| 情况 | 升级给谁 | 为什么 |
|---|---|---|
| 试点项目没有任何 owner | Sponsor | 没有 owner 的项目不能试点 |
| 产品验收人缺席 | Product Owner / Sponsor | 做完没人判断价值 |
| 本地环境无法在半天内跑起 | Ops Owner / 平台负责人 | 开发闭环不成立 |
| CI 失败没人处理 | Tech Owner / Ops Owner | PR 门禁不可信 |
| 发布入口或回滚方式不清 | Ops Owner / Sponsor | 上线风险不可接受 |
| 涉及客户数据、权限、支付、密钥 | 安全 / 合规负责人 | 高风险动作需要额外门禁 |
| 工具太多但事实不一致 | 三角色一起 | 需要重新定义事实来源 |
和已有文档的关系
| 要解决的问题 | 继续看 |
|---|---|
| 工具各自负责什么 | 04-工具栈和边界-tool-stack-boundaries.md |
| 工作怎么进入任务系统 | 13-工作入口-work-intake.md |
| 任务、PR、CI、发布怎么链接 | 14-任务联动-task-linkage.md |
| 三角色和组员怎么协作 | 16-三角色协作流程-three-role-collaboration-flow.md |
| 怎么执行试点 | 71-试点落地手册-pilot-rollout-playbook.md |
下一步阅读
读完或填完这份文档后，通常继续看：
- 73-试点确定方案-pilot-decision.md：如果需要最终拍板，先看确定版方案。
- 71-试点落地手册-pilot-rollout-playbook.md：讨论清楚后，用试点手册执行两周试点。
- 试点验收-pilot-acceptance.md：试点过程中用验收模板记录证据和结论。