一、 定位与设计原则

• 定位：技术需求（Tech Requirement）是由技术团队主动发起的技术改进事项，涵盖架构重构、性能优化、安全加固、技术债清还、新技术引入、基础设施升级等场景。它不经过产品需求的 PRD/UI 流程，由技术负责人全程主导，评审通过后直接拆分为开发任务。
• 与产品需求的核心区别：

• 创建来源：
  1. 技术负责人 / 工程师直接手动创建（最常见）。
  2. 原始需求决策为"技术改造"时，由系统自动触发并关联。

二、 节点详细配置

1. 节点：技术提案

• 负责人：创建者（技术工程师或技术负责人）。
• 节点描述：记录技术问题的背景、目标和预期价值，为后续评审提供充分上下文。
• 节点字段：
  • 技术需求标题 (必填，格式建议：【类型】简述)
  • 背景与动机 (必填，富文本：现状痛点 + 为什么现在解决)
  • 技术目标 (必填，列出具体可衡量的成功指标)
  • 预期收益 (文本，如：接口响应时间降低 30% / 消除某类安全漏洞)
  • 技术类型 (必填，单选：架构重构 / 性能优化 / 安全加固 / 技术债清还 / 新技术引入 / 基础设施升级 / 其他)
  • 涉及系统 / 模块 (多选)
  • 优先级 (单选：P0-紧急 / P1-高 / P2-中 / P3-低)
  • 关联项目 (必填，关联项，关联所属技术项目)
  • 关联原始需求 (关联项，可选，来自用户反馈时填写)
  • 提出人 (人员，自动填充为创建者)
• 流转方式：需点击确认完成。
• 回滚支持：不支持（起始节点）。
• 预置任务：无。

2. 节点：方案设计

• 负责人：技术负责人。
• 节点描述：输出完整技术方案文档，明确改造范围、技术选型和实施路径。
• 节点字段：
  • 技术方案文档链接 (必填，飞书文档 / GitLab Wiki)
  • 架构变更说明 (文本，是否改变现有架构，变化点在哪里)
  • 数据库变更 (单选：是 / 否，若"是"则附上变更方案)
  • 涉及技术栈 (多选：前端 / 后端 / 客户端 / 算法 / 运维 / 数据)
  • 预估总人天 (数字)
  • 计划开始日期 (日期)
  • 计划完成日期 (日期)
  • 潜在风险 (文本，列出主要技术风险点)
• 流转方式：需点击确认完成。
• 回滚支持：支持回滚至"技术提案"（场景：调研后发现背景信息不完整需补充）。
• 预置任务：
  1. 调研现有方案和业界最佳实践
  2. 评估技术风险和影响范围

3. 节点：方案评审

• 负责人：技术负责人。
• 节点描述：组织技术评审会议，对方案进行集体评估，确认可行性和工作量。P0/P1 级技术需求需 CTO 参与。
• 节点字段：
  • 评审结论 (必填，单选：通过 / 不通过 / 需修改后复评)
  • 评审人 (多选人员，必填)
  • 评审纪要链接 (URL，必填)
  • 最终预估人天 (数字，必填，评审后确认的工作量)
  • 技术风险备注 (文本)
  • 遗留待办事项 (文本，评审中未解决的问题)
• 流转方式：需点击确认完成。
• 流转条件：评审结论为"通过"，最终预估人天已填。
• 回滚支持：支持回滚至"方案设计"（场景：方案存在根本性问题需重新设计）。
• 预置任务：
  1. 发起技术评审会邀约（邀请 CTO / 技术负责人 / 相关工程师）
  2. 整理评审意见和待确认问题

4. 节点：任务拆分

• 负责人：技术负责人。
• 节点描述：将评审通过的技术方案拆解为具体的开发任务，分配给各技术栈负责人。
• 节点字段：
  • 关联开发任务 (关联项，必填，至少关联 1 个)
  • 拆分说明 (文本，描述各任务之间的依赖和执行顺序)
  • 各技术栈负责人 (多选人员)
• 流转方式：需点击确认完成。
• 流转条件：至少关联 1 个开发任务。
• 回滚支持：支持回滚至"方案设计"（场景：拆分过程中发现方案不可落地）。
• 预置任务：
  1. 按技术栈拆分开发任务（粒度建议 1-3 天）
  2. 确认各任务依赖关系和执行顺序

5. 节点：执行中

• 负责人：研发负责人。
• 节点描述：跟踪开发任务整体进度，管理执行风险。
• 节点字段：
  • 实际开始日期 (日期时间，自动填充)
  • 整体进度 (公式：已完成开发任务数 / 总关联开发任务数 × 100%)
  • 风险预警状态 (单选：🟢 正常 / 🟡 有风险 / 🔴 严重滞后)
  • 风险说明 (文本，当状态非"正常"时必填)
• 流转方式：需点击确认完成。
• 流转条件：全部关联开发任务进入"提测"节点或以上。
• 回滚支持：不支持（执行中如需调整，通过更新开发任务处理）。
• 预置任务：无（进度通过开发任务状态自动汇聚）。

6. 节点：验收

• 负责人：技术负责人（P0 级技术需求由 CTO 参与）。
• 节点描述：对技术改造成果进行验收，核验是否达到技术目标中设定的指标。
• 节点字段：
  • 验收结论 (必填，单选：通过 / 不通过)
  • 技术指标达成情况 (文本，必填，对比"技术目标"与实际测量结果)
  • 验收说明 (文本)
  • 测试报告 / 性能数据链接 (URL)
• 流转方式：需点击确认完成。
• 回滚支持："不通过"时支持回滚至"执行中"（返回修复后再次验收）。
• 预置任务：无。

7. 节点：已完成

• 负责人：技术负责人。
• 节点描述：技术需求生命周期终态，确保技术文档归档完整。
• 节点字段：
  • 实际完成日期 (日期时间，自动填充)
  • 技术文档归档链接 (URL，必填，确保方案文档可持续访问)
  • 经验总结 (文本，记录踩坑点和可复用经验)
• 流转方式：需点击确认完成。
• 回滚支持：不支持（终态节点）。
• 预置任务：
  1. 更新相关系统文档 / Wiki
  2. 确保代码已 Merge 至主干并标 Tag

三、 自动化规则

1. 评审通过提醒：方案评审节点流转（评审结论="通过"）→ 自动推送提醒给技术负责人："技术需求评审通过，请在 2 个工作日内完成任务拆分"。
2. 全部任务完成：全部关联开发任务流转至"验收"完成 → 自动推送"技术需求可进入验收"通知给技术负责人。
3. 逾期预警：当前日期 > 计划完成日期 且 节点未达到"验收" → 风险预警状态自动变为"🟡 有风险"，推送提醒给技术负责人 + CTO。
4. 来源回写：技术需求流转至"已完成" → 若关联了原始需求，自动更新原始需求的"关联对象"字段。

四、 字段快速参考