工作入口
目的
为 feature、bug、技术债、实验和事故 action 定义统一入口。
工具
| 需要 | 推荐工具 |
|---|---|
| 工作跟踪 | Linear |
| 企业重流程替代 | Jira |
| 轻量 repo-native | GitHub Issues |
| Spec 和 discovery notes | Notion/Lark 或 repo docs |
| 永久技术决策 | Repo 中的 ADR |
从需求到开发的工具流
| 步骤 | 工具 | 谁负责 | 组员参与方式 |
|---|---|---|---|
| 记录需求 | Linear/Jira/GitHub Issue | 产品负责人 / Requester | 补充客户反馈、截图、背景 |
| 补功能简报 | Notion/Lark Docs 或任务描述 | 产品负责人 | 设计、运营、客服补充场景 |
| 指定 Driver | 任务卡 | 产品负责人 / 技术负责人 | 执行人确认是否能接 |
| 技术风险初筛 | 任务卡 / RFC / ADR | 技术负责人 | 工程师补影响范围 |
| 运行和验证条件 | docs/PROJECT.md / CI |
平台 / 资深工程师 | 执行人试跑命令并反馈 |
| 进入开发 | 任务状态 Planned / In Progress | Driver | 组员按子任务执行 |
更完整的协作流程见 16-三角色协作流程-three-role-collaboration-flow.md。
工作类型
| 类型 | 必填字段 |
|---|---|
| Feature | 用户、问题、目标、成功指标、非目标、验收标准、Driver、Approver、Business Approver |
| Bug | 影响、严重度、复现步骤、期望行为、实际行为、影响版本 |
| 技术债 | 风险、受影响模块、建议清理方式、不做的代价、Driver |
| 实验 | 假设、指标、时间窗口、rollout、停止条件 |
| 事故 action | 事故链接、根因、行动项、Driver、截止时间 |
最小闭环字段
草台团队最容易断在“有人提了,但没人推进;有人做了,但没人拍板”。所以每个工作项至少要有这些字段:
| 字段 | 说明 | 没有时会怎样 |
|---|---|---|
| Requester | 谁提出问题,能解释背景 | 做错问题也没人澄清 |
| User / Customer | 谁受影响 | 做成了内部想象的功能 |
| Problem | 用户或业务现在卡在哪里 | 只是在实现某个方案 |
| Success Signal | 用什么信号判断有效 | 上线后不知道有没有价值 |
| Driver | 谁推动任务从记录到关闭 | 大家都知道,但没人推进 |
| Approver | 谁对 scope、验收、风险接受拍板 | 多人意见打架,任务卡住 |
| Reviewer | 谁判断实现是否可接受 | 做完没人敢合并 |
| Business Approver | 用户可见功能由谁验收 | 做完后业务不认 |
| Scope | 这次允许改什么,不改什么 | 小任务膨胀成大重构 |
| Acceptance | 怎么算完成 | 做完没人能关单 |
| Evidence | 需要什么测试、截图、日志或 PR | 只能靠口头说“好了” |
Driver 和 Approver 可以是同一个人,但字段必须显式。多人共同负责等于没人负责。
开发就绪定义
工作进入开发前必须满足:
- 问题说明清楚。
- 用户或客户是谁清楚。
- 成功信号或验收标准清楚。
- Driver 和 Approver 明确。
- 优先级理由和目标时间明确。
- 依赖列出。
- 数据、安全、生产风险已标注。
- 目标 repo 或产品区域已知。
草台版最低要求可以更短:
目标
-> 用户 / 问题
-> Driver
-> Approver
-> Scope
-> 验收标准
这 6 项不满足时,只能进入 clarification / planning,不能进入 implementation。
用户可见功能还需要明确 Business Approver。它可以和 Approver 是同一个人,但必须有人负责业务验收。
产品闭环细节见 20-产品闭环-product-closure.md。
三角色开发准入
进入开发前,三类角色各自确认一件事:
| 角色 | 必须确认 | 如果不清楚 |
|---|---|---|
| 产品负责人 | 用户、问题、目标、优先级理由、Business Approver | 进入 clarification,不进入开发 |
| 技术负责人 | scope 是否合理,是否涉及架构、安全、数据、支付或高风险路径 | 先做技术设计或风险评审 |
| 平台 / 资深工程师 | 目标 repo、运行方式、检查命令、依赖服务是否明确 | 先补 docs/PROJECT.md 或开发环境说明 |
状态模型
使用简单共享状态:
Intake -> Clarifying -> Planned -> In Progress -> In Review -> Ready to Release -> Done
-> Blocked
-> Rejected
-> Cancelled
状态含义:
| 状态 | 进入条件 | 退出条件 |
|---|---|---|
| Intake | 需求刚被记录 | Driver 完成初筛 |
| Clarifying | 目标、scope、Driver / Approver 或验收不清 | Approver 确认是否进入 Planned |
| Planned | 已有 Driver、Approver、scope、验收和优先级 | Driver 安排执行 |
| In Progress | 有人正在执行 | 产生 PR、patch、截图、测试结果或其他交付证据 |
| In Review | 等待 reviewer 或 approver 判断 | merge、retry、block 或 reject |
| Ready to Release | 已合并或可发布 | 发布完成或取消发布 |
| Done | 验收和结果记录完成 | 无 |
| Blocked | 等待外部输入或决策 | blocker 被移除 |
| Rejected | 决定不做 | 记录原因 |
| Cancelled | 曾计划或执行,但后来取消 | 记录原因 |
紧急通道
线上事故、客户现场、老板急活可以先处理,但必须补闭环。执行人临时成为 Driver;直属小组长或当班负责人是 Approver。
先止血
-> 24 小时内补任务卡
-> 补 PR / patch / 发布记录
-> 补验证证据
-> 明确后续 action
紧急通道不能绕过 review 和记录,只是允许先止血再补齐。连续出现同类紧急任务时,必须创建复盘或技术债任务。
这些事项不能只走事后补审:
- 权限和鉴权变化。
- 支付、计费、提现、资金相关逻辑。
- 客户数据导出或删除。
- 生产密钥、证书、云权限变化。
- 破坏性数据库 migration。
- 大范围批量操作。
Linear 设置建议
| Linear 对象 | 用法 |
|---|---|
| Team | 产品小队或平台团队 |
| Project | 产品 initiative 或大型技术 initiative |
| Cycle | 1-2 周计划窗口 |
| Issue | 单个工作项 |
| Label | bug、feature、tech-debt、security、incident-action |
| Priority | 业务和风险优先级 |
后续 Agent 就绪要求
这一节在人类闭环稳定后再看。当前阶段先保证人类任务字段完整。
Agent 执行需要工作项包含:
- 任务标题。
- 验收标准。
- Repo 和分支策略。
- Scope 边界。
- Reviewer。
- 允许工具或风险等级。
- Human Approver。
- 预期 artifact 类型。
缺少这些字段时,应先创建 planning task,而不是直接启动执行 run。
下一步阅读
读完或填完这份文档后,通常继续看:
- 14-任务联动-task-linkage.md:任务进入系统后,继续看任务、PR、文档和发布如何互相链接。