Feature 开发包标准

文档状态

approved

文档 Owner

DOC

事实源

canonical-docs

更新

2026/10/14

本标准适用于 AutoDev Platform 的全部功能。目标不是让每个 Feature 拥有相同页数，而是让任何进入开发的功能具备相同的、可机器检查的输入与出口。

必需资产

生命周期	必需	条件必需
Identified / stub	FEAT、owner、边界、未知项、下一责任人	—
Development Ready	原子 REQ、AC、设计 / 工程合同、Code Map、M、WP、TEST 计划	有 UI 时 UI / FLOW；跨进程或存在并发、租约、重试、状态收敛时 MECH；跨进程时 API / PROT / EVT；持久化时 SCH / migration；关键取舍时 ADR
Verification Ready	TEST spec、正式 test locator、FIX / 环境、failure oracle、release gate	并发、权限、幂等、超时、崩溃、网络、兼容、迁移、E2E / smoke 按风险加入
Release Ready	implementation revision、受保护测试 / build evidence、兼容 / migration、RB / rollback	SLO、security evidence、production approval、data backup 按变更加入

原子 Requirement

每条 REQ 使用永久 Asset ID，并同时声明：规范性陈述、强度、engineering owner、前置、输入、行为、错误 / fail-closed、AC、implemented_by、verified_by。一句需求不得混合多个可以独立失败或由不同 owner 实现的行为。

Code Map

Code Map 必须包含 owner repo、40 位 base revision、允许修改的模块 / 文件 / symbol、existing / change、正式测试 locator、跨仓顺序和 forbidden scope。来源必须来自固定 asset snapshot；“后端”“相关代码”“master 最新”均不合格。

测试规格

测试项包含 Test ID、REQ / AC、层、前置、fixture、Given / When / Then、failure oracle、test locator、environment、release gate。unit mock 不能替代数据库并发、真实协议、进程终止或目标环境 smoke。

Work Package

WP 包含 Asset ID、repo / base、implements、scope / forbidden scope、depends_on、acceptance、verification、rollback、completion evidence。它应在一个 owner repo 内可独立交付；跨仓协调使用 Milestone 和依赖关系，不创建无法判断完成的“大任务”。

页面与结构

Feature index 始终存在，是该功能的 canonical 产品需求入口。非 stub Feature 的 index 按 PRD 标准组织背景、目标、用户、范围 / 非目标、需求概要、验收与成功判定、 依赖、风险、状态边界和专项文档导航；原子 REQ / AC、工程算法、协议字段、测试步骤和实施任务仍由子页承载， 不能在首页复制两套合同。stub 只保留已知目标、明确未知项和下一责任人，不得用空 PRD 模板伪装完整性。

只有复杂度需要时增加子页：requirements、user experience、architecture、mechanisms、API / protocol、configuration / extension、data / state / errors、security / NFR、Code Map、test specification、implementation plan、rollout / migration、runbook、ADR。Mechanism 必须说明触发、参与者、逐步算法、读写状态、事务 / 并发边界、幂等 / 超时、失败分支、收敛、代码定位和测试，不得用架构图或 API 表代替。禁止创建空模板以伪装完整性。

状态边界

文档状态表示合同批准程度，产品生命周期表示能力阶段，readiness 表示工程输入 / 验证 / 发布是否齐备，Plane 状态表示实际执行进度。四者不得合并成一个 status 字段。