loveliunian devflow — PRD to production（v3.28.10）
本文件是唯一权威入口。历史迁移只查 references/CHANGELOG.md；命令、阶段、角色和模板按需加载，不在入口重复。
输入 / 输出契约
- 输入（必需）：PRD 路径或等价需求文本；交付模式
new/change/extend/small-change。 - 输入（可选）：
--frontend=pc-web|mini-program|app|not-applicable、service、迁移策略、--design-only。 - 每阶段输出 Receipt：
phase、status: PASS|BLOCKED|SKIPPED、artifacts[]、verification[]、blockers[]、next_phase。 - Gate 失败不得推进；外部副作用先有授权收据（原则 14）。
适用范围
- 从零构建、存量系统新增、已有需求修改。
- 基于现有项目的小需求、小改动可由自然语言触发
/small-change；必须先扫描当前项目，风险扩大时自动升级完整change流程。 - 服务端先按
references/runtime-profile.md解析 Runtime Profile；java-spring-flyway是内置参考 Profile，其他技术栈在 P1 冻结等价 adapter（build/test/security/migration），核心流程不假设具体框架。 - 客户端覆盖 PC Web、微信小程序、APP 或明确的
not-applicable前端范围。 - PRD 到详设、实现、测试、部署、监控、文档、复盘，或从 checkpoint 恢复。
- 测试生成器（v3.28+）：P5 从
design.json/acceptance.json生成 JUnit/Playwright 测试骨架。详见references/test-generators.md。
仅概念问答或独立代码审查，不启动全流程。
不可违背的原则
- 每阶段 Gate 返回 0 后才能推进；文档存在、静态构建或 H2 结果不能替代真实运行证据。
- 完成声明附命令、退出码、文件和环境边界；
运行未验证不得写成完成。 - 开发、审查、完成度审计角色分离；不能自签。
- 按“数据 + API + 客户端 + 测试 + 可达性”垂直切片。
- 适用 Flyway 时保持 h2、postgresql、oracle、kingbase 四方言一致；不适用需在冻结设计说明。
- 测试凭据只能从 seed 或配置事实源追溯，禁止猜测和记录明文秘密。
- 写产物前读对应模板，写后跑对应 Gate；模板与产物标题和字段契约一致。
写产物【前】先跑
scripts/gate-contract.sh <阶段>读该阶段门禁契约卡（references/gate-contracts.md：机检行、禁用词、证据绑定、已知劫持点），按契约一次写对，避免试错返工。 - Gate 失败立即保存 checkpoint、记录证据并停止；修复后重跑同一 Gate。
- P10 教训先写入项目本地 feedback queue；修改已安装 skill 须获用户明确批准。
- 设计必须显式说明成熟组件复用、公共服务/组件抽取、命名/开发/注释规范及关键设计理由。
- 评审必须先跑主责探针再下结论：深层发现（DF）按五字段场景链契约输出，零发现 ✅ 须附核查证据；规范见
concepts/review-depth-methodology.md。 - 用户/PRD 明确指定的技术组件、版本、许可证或部署方式必须在 P0 冻结为硬约束；P1 只能在约束内评分，偏离必须
BLOCKED并经用户批准后重冻。 - P3 前解析 Runtime Profile；核心流程不假设 Maven/Spring/Flyway/JaCoCo/Vue，仅 profile 声明的能力可作验证依据；能力缺失即（命令位现仅参考实现栈可用，详见运行时配置档案）
BLOCKED。 - 部署、迁移、推送、发布等外部副作用必须有显式人工授权收据（
authorizations/release.json）；无授权时最高声明READY_TO_RELEASE，不得声明RELEASED。 - 面向读者文档必须遵循
concepts/中文文风规范.md；人工自检、抽查，不设自动文风硬校验或Gate阻断。
完整铁律与工程边界见 concepts/core.md；细节原则见 concepts/principles-detailed.md；经验教训库见 concepts/lessons-learned.md（33 条可复现教训 + 启动检查清单）。
启动与路由
- 先读
concepts/core.md。 - 读
commands/ROUTING.md，选择全流程或单阶段命令。 - 只加载当前 command、phase、subagent、template 和 Gate 脚本。
- 初始化时冻结
--frontend=pc-web|mini-program|app|not-applicable；小程序、APP 和配置化 PC Web 在 P2 后冻结devflow-client.json哈希。
“小需求/小改动、局部 UI、配置、修复、字段/默认值/校验”等先加载 commands/small-change.md；SMALL-CHANGE 默认只到 MERGE_READY，明确要求上线才绑定 P7+P8 收据并声明 RELEASED。
全流程编排、参数、Gate 调用、跳过与恢复见 commands/devflow.md。自然语言触发与反例见 concepts/natural-language-triggers.md。
过程性产物命名（v3.22.0 起）
- 给人看的过程性文档默认用中文名：目录如
docs/需求、docs/详细设计、docs/评审、docs/测试、docs/测试报告、docs/发布、docs/复盘、docs/知识沉淀；文件如<feature>-需求澄清.md、<feature>-PRD验证报告.md、<feature>-单元测试报告.md、<feature>-集成测试报告.md、<feature>-客户端旅程报告.md、<feature>-压测报告.md、<feature>-预发布验证报告.md、<feature>-终验报告.md、<feature>-部署记录.md、<feature>-监控配置.md、<feature>-知识分享.md；P7/P8 证据文件同理。完整中英映射见scripts/devflow_paths.sh。 - 所有 Gate 中文优先、英文回退：历史英文路径（
docs/requirements/、<feature>-unit-report.md等）继续被接受，在途项目无需迁移。 - 机器契约层不翻译：
.devflow/下receipt.txt/*.state.json/<kind>.json/*.tsv/*.env/gates/及 stage 名（P0-P10）、feature 标识保留英文。
全阶段结构化产物（v3.25.2）
每个环节的 md 产物有 JSON 正本，按 schema 契约填 .devflow/<feature>/<kind>.json，经 df_pipeline.py <kind> 校验渲染进 Gate，空集合须 zero_results 声明。kind↔阶段映射见上表。
Gate 强制矩阵（P0/P2/P3c/P3d/P6）见 references/structured-artifacts.md。
P0-P10 单轨
| 阶段 | 目标 | Gate |
|---|---|---|
| P0/P0b | 澄清、原子验收点、PRD 评审（DF/AW 深度契约 + 领域专项清单） | df_pipeline.py clarification/acceptance/constraints、s0_acceptance_gate.sh、df_pipeline.py prd-review、gen-domain-checklist.sh、artifact_gate.sh P0b |
| P1 | 技术选型与工程事实源 | df_pipeline.py tech-selection、s1_fact_sources_gate.sh |
| P2/P2a/P2b | 字段级详设、5 角色评审（DF/AW 深度契约）、原型 | df_pipeline.py design（design.json 结构化产物层，失败关闭）、s2_design_coverage_gate.sh（§2c 对账）、df_pipeline.py design-review、p2a_design_review_gate.sh、p2b_demo_gate.sh |
| P3/P3b/P3c/P3d | 实现、代码审查、安全、性能 | build-watchdog.sh gate（P3-build）、df_pipeline.py self-check、p3_completion_gate.sh、df_pipeline.py code-review、p3b_code_review_gate.sh、p3_security_perf_gate.sh |
| P4/P4b | PRD 验证与精确 PRD-vs-Code | df_pipeline.py prd-validation、p4_validation_gate.sh、p4_prd_vs_code.sh |
| P5/P6 | 测试设计、执行、迁移、凭证、准确率（P5 自动生成测试骨架） | df_pipeline.py test-cases、p5_test_cases_gate.sh(主)、s5_migration_gate.sh(B/C，P5-migration)、s6_first_pass_accuracy.sh、p6_credential_gate.sh |
| P6 终验 | 部署前强制（定位：交付把关而非缺陷发现——只回答"功能已实现且真实可运行"，缺陷发现在 P3/P3b/P4）：验收点集合与冻结基线全等、FAIL=0；测出的问题必须修复→重跑 Gate→循环直到测不出问题，禁止带病交付或降断言换绿灯；Gate 实际执行五类测试命令并绑定报告、日志与真实退出码；verification.json 必填并对账冻结前端范围 | s6_final_verification_gate.sh（执行→校验→渲染报告→收据绑定 gates/P6-final/，缺失则 complete P6 拒绝） |
| P7/P8/P9 | 部署、监控、文档 | df_pipeline.py deployment/monitoring/docs-index、artifact_gate.sh P7/P8/P9 |
| P10 | 复盘与项目反馈闭环 | df_pipeline.py retrospective、p10_feedback_gate.sh |
P11 只用于独立事故复盘，不计入正常交付链。
停止条件
- 输入、冻结哈希或证据漂移：回到最早受影响阶段。
- Gate 非零或独立审计不可用：报告
BLOCKED，不得继续或自签。 - 用户明确授权的合法跳过必须写入
.devflow/<feature>/skip-log.txt；P3、P4b、P6、P7-P10 不可跳过。
发布技能自身前必须运行唯一发布入口 bash scripts/release.sh（含完整测试、版本一致性、Release Audit、ShellCheck、Manifest、副本对账、树 hash 七道门禁，任一失败即禁止发布）。