工作入口

目的

为 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 可以是同一个人,但字段必须显式。多人共同负责等于没人负责。

开发就绪定义

工作进入开发前必须满足:

  1. 问题说明清楚。
  2. 用户或客户是谁清楚。
  3. 成功信号或验收标准清楚。
  4. Driver 和 Approver 明确。
  5. 优先级理由和目标时间明确。
  6. 依赖列出。
  7. 数据、安全、生产风险已标注。
  8. 目标 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 和记录,只是允许先止血再补齐。连续出现同类紧急任务时,必须创建复盘或技术债任务。

这些事项不能只走事后补审:

  1. 权限和鉴权变化。
  2. 支付、计费、提现、资金相关逻辑。
  3. 客户数据导出或删除。
  4. 生产密钥、证书、云权限变化。
  5. 破坏性数据库 migration。
  6. 大范围批量操作。

Linear 设置建议

Linear 对象 用法
Team 产品小队或平台团队
Project 产品 initiative 或大型技术 initiative
Cycle 1-2 周计划窗口
Issue 单个工作项
Label bug、feature、tech-debt、security、incident-action
Priority 业务和风险优先级

后续 Agent 就绪要求

这一节在人类闭环稳定后再看。当前阶段先保证人类任务字段完整。

Agent 执行需要工作项包含:

  1. 任务标题。
  2. 验收标准。
  3. Repo 和分支策略。
  4. Scope 边界。
  5. Reviewer。
  6. 允许工具或风险等级。
  7. Human Approver。
  8. 预期 artifact 类型。

缺少这些字段时,应先创建 planning task,而不是直接启动执行 run。

下一步阅读

读完或填完这份文档后,通常继续看: