tencent DevFlow
必须执行
- 将用户当前目录设为
PROJECT_ROOT，不向父目录寻找或自动切换项目。先读取宿主项目指令，再运行python3 <SKILL_ROOT>/scripts/inspect_context.py .发现实际项目约定。 - 开始任何阶段前读取 rules/core.md。
rules/不会被宿主自动加载；build_stage_prompt.py按 rules/manifest.json 确定性注入核心规则、当前阶段规则，以及由项目证据命中的专项规则。 - 完整流程读取 references/workflow-contract.md。medium/large 额外读取 references/agent-execution.md 和 references/runtime-core.md，并且只加载一个匹配的
adapters/实现。 - 每阶段优先用
workflow_state.py prepare ... --emit-prompt一次完成模板准备和提示生成，再执行start → finish；仅对已经 prepare 的恢复状态单独调用build_stage_prompt.py。REQUIREMENT 和 SUMMARY 由协调者在当前上下文执行，不创建阶段 Agent；isolated 模式的其他 route 阶段在 prompt 后、start 前增加spawn → assign。只有宿主真实返回 executor ID 后才能assign，并登记 adapter 要求的executor_type。 - REQUIREMENT 调用
$devflow-clarify-requirements完成证据分析、用户交互和需求报告。报告通过内容校验后必须向用户展示摘要并等待明确确认；只有确认后才能执行approve --stage REQUIREMENT --user-confirmed并进入 DESIGN。DESIGN 及后续 isolated 阶段只读取清单允许的上游产物和当前必要证据，协调者不得代写。
脚本仅依赖 Python 3.8+ 标准库。Python 不可用时读取 references/manual-runtime.md 执行等价门禁，不得跳过。
按需读取
- 前端、后端、Go、SQL 和设计稿专项规则由阶段 Prompt 自动选择；分类不明确但用户或项目已确认时，用
build_stage_prompt.py --profile <id>显式追加。 - 审查、测试和知识沉淀规则按阶段自动注入；规则入口见 references/quality.md。
- 用户明确要求预览或部署：references/preview-deploy.md
无法分类时先检查项目证据；不要为了“可能相关”注入全部专项规则。混合项目可以组合多个 profile。
不可绕过
agents/manifest.json是逻辑角色、职责和上游阶段的唯一事实源；templates/manifest.json是产物的唯一事实源。adapter 只映射少量宿主执行器，不得复制逻辑角色清单。prepare只生成缺失模板并记录基线，不覆盖已有产物。阶段执行者填写模板并删除所有{{...}}；不要为标题措辞或排版反复返工。- medium/large 的 REQUIREMENT 和 SUMMARY 由协调者执行；DESIGN、IMPLEMENT、REVIEW、TEST 分别使用独立 Agent。KNOWLEDGE 是条件阶段：有新增可复用知识才创建 Agent，否则用
decide-knowledge --decision skip --reason ...留下依据并跳过；不得按 size 一刀切。宿主确实不支持时才允许带具体原因的single-context降级。 - REQUIREMENT 的用户确认门禁在
auto和manual模式下都不可跳过；没有用户明确确认时不得创建 DESIGN 执行者。 - 保护用户已有改动，不自动 stash、commit、push、部署或执行其他未授权外部写操作。
- 只依据真实命令、观察和产物宣布完成，明确区分 passed、failed、blocked、not-run。