harness-flow

Implement the current active HarnessFlow task with TDD and fresh evidence (hf-test-driven-dev). Only valid when exactly one Current Active Task is locked.

Route-first entry. When you are not sure which HarnessFlow node should run next, use this. The router will recover the right next node from on-disk artifacts.

Bias toward the HarnessFlow planning stage — design (and UI design when the spec declares a UI surface) plus task breakdown. The router decides whether to enter hf-design, hf-ui-design, or hf-tasks based on artifact evidence.

Request a HarnessFlow review. The router dispatches to the correct hf-*-review skill (discovery / spec / design / ui / tasks / test / code / traceability) based on artifact context.

Ask the HarnessFlow completion gate whether the current task or workflow can be closed out, then enter hf-finalize if the gate allows.

Bias the next HarnessFlow step toward spec authoring or revision (hf-specify). The router still validates upstream preconditions before letting hf-specify run.

Use when AI notices repeated mistakes, recurring review findings, or bugfix lessons that may deserve codifying as a reusable bug pattern with human confirmation before writing to a catalog.

适用于 test review 通过后评审代码质量、用户要求 code review 的场景。不适用于评审测试（→ hf-test-review）、写/修代码（→ hf-test-driven-dev）、阶段不清（→ hf-workflow-router）。

适用于 regression gate 之后需判断任务完成走向、确认任务可宣告完成、用户要求\"能不能算完成\"的场景。不适用于缺回归记录/实现交接块需补齐（→ hf-regression-gate）、需状态收尾（→ hf-finalize）、阶段不清（→ hf-workflow-router）。

适用于设计草稿已完成需要正式 review verdict、或被指定为 reviewer subagent 执行设计评审的场景。不适用于需继续写或修设计（→ hf-design）、需拆任务或编码（→ hf-tasks）、阶段不清或证据冲突（→ hf-workflow-router）。

适用于需求规格已批准但设计尚未批准、或设计评审返回需修改/阻塞需修订的场景。不适用于规格仍是草稿/待批准（→ hf-specify）、设计已批准需拆任务（→ hf-tasks）、仅需执行设计评审（→ hf-design-review）、阶段不清或证据冲突（→ hf-workflow-router）。

适用于 discovery 草稿已完成需要正式 review verdict、或被指定为 reviewer subagent 执行 discovery 评审的场景。不适用于需继续写 discovery 正文（→ hf-product-discovery）、已明确进入 formal spec（→ hf-specify）、或阶段不清 / 证据冲突（→ hf-workflow-router）。

适用于已通过 hf-regression-gate、即将进入 hf-completion-gate、需要为本任务/本 feature 引入的对外可见行为变化判定相关用户文档（仓库根 README 产品介绍段、模块层 README、公共 API doc / OpenAPI / docstring、i18n 副本、CONTRIBUTING / onboarding doc、用户文档站 source）是否同步刷新的场景。不适用于尚未通过 hf-regression-gate（→ 上游）、纯 prose feature 但 reviewer 误以为强制 lint 工具链、阶段不清或证据冲突（→ hf-workflow-router）。

适用于产品发现或规格阶段存在低 confidence、高风险或 Blocking 的关键假设，需要一次最小可验证 probe 再决定是否推进主链。不适用于无假设驱动的纯澄清（→ hf-specify）、需新起 discovery（→ hf-product-discovery）、进入正式实现（→ hf-test-driven-dev）、阶段不清（→ hf-workflow-router）。

Use when completion gate already allows closeout and the remaining work is state/doc/release-note closure, either for the current completed task or for the whole workflow cycle.

适用于线上/紧急缺陷需要修复、用户要求 hotfix 分析、缺陷需要复现路径和最小修复边界的场景。不适用于写/修代码（→ hf-test-driven-dev）、需求变更/范围调整（→ hf-increment）、阶段不清（→ hf-workflow-router）。

适用于用户明确要求增删改需求/范围/验收/约束、hf-workflow-router 判定属于 increment 分支的场景。不适用于实现缺陷修复（→ hf-hotfix）、继续实现（→ hf-test-driven-dev）、阶段不清/证据冲突（→ hf-workflow-router）。

适用于仍在判断产品问题、目标用户、wedge、关键假设或 probe 方向，尚未收敛到 formal spec 的场景。不适用于已明确进入 spec/design/tasks（→ hf-specify / hf-workflow-router）、或只需评审已有 discovery 草稿（→ hf-discovery-review）。

适用于 traceability review 通过后需回归验证、用户要求 regression check 的场景。不适用于判断任务完成（→ hf-completion-gate）、状态收尾（→ hf-finalize）、阶段不清（→ hf-workflow-router）。

适用于规格草稿已完成需正式 review verdict、reviewer subagent 被派发执行规格评审的场景。不适用于缺规格草稿或只需继续写（→ hf-specify）、阶段不清或证据冲突（→ hf-workflow-router）、已有已批准规格需设计评审（→ hf-design-review）。

适用于尚无已批准规格、现有规格仍是草稿、或规格被 hf-spec-review 退回需修订的场景。不适用于已有批准规格（→ hf-design）、需要任务计划（→ hf-tasks）或阶段不清（→ hf-workflow-router）。

适用于任务计划草稿需正式 review verdict、任务计划被退回需复审、或用户显式要求评审任务计划的场景。不适用于写/修任务计划（→ hf-tasks）、阶段不清（→ hf-workflow-router）。

适用于规格与设计都已批准、需要在编码前产出可评审任务计划的场景。不适用于规格/设计未稳定（→ hf-specify / hf-design）、任务计划已批准需进入实现（→ hf-test-driven-dev）、或阶段不清（→ hf-workflow-router）。

适用于任务计划获批后的单任务实现、受控 hotfix 修复实现、review/gate 回流修订。不适用于任务计划未批准（→ 上游）、hotfix 无复现路径（→ hf-hotfix）、需并行多任务（→ hf-workflow-router）。

适用于实现完成后判断测试质量、code review 前的测试评审、用户显式要求评审测试的场景。可吸收 bug pattern 目录或 hf-bug-patterns 的候选经验作为风险输入，但不以其完成为前置。不适用于写/修测试（→ hf-test-driven-dev）、评审代码（→ hf-code-review）、阶段不清（→ hf-workflow-router）。

适用于 code review 通过后判断追溯完整性、用户显式要求追溯评审的场景。不适用于评审代码质量（→ hf-code-review）、评审测试质量（→ hf-test-review）、阶段不清（→ hf-workflow-router）。

适用于规格含 UI surface（页面/组件/交互/前端）且设计未批准、或 hf-ui-review 返回需修改/阻塞需修订的场景。不适用于纯后端/脚本/API-only（不激活本节点）、架构与 API 契约（→ hf-design）、规格仍是草稿（→ hf-specify）、设计已批准需拆任务（→ hf-tasks）、只需执行 UI 评审（→ hf-ui-review）、阶段不清或证据冲突（→ hf-workflow-router）。

适用于 UI 设计草稿已完成需要正式 review verdict、或被指定为 reviewer subagent 执行 UI 设计评审的场景。不适用于需继续写或修 UI 设计（→ hf-ui-design）、评审架构/技术设计（→ hf-design-review）、需拆任务或编码（→ hf-tasks）、阶段不清或证据冲突（→ hf-workflow-router）。

适用于用户说"继续/推进"需判断当前节点、review/gate 刚完成需恢复编排、route/stage/profile 不清、工件证据冲突、需判断是否进入 hotfix/increment 的场景。不适用于新会话 family discovery（→ using-hf-workflow）。

适用于新会话不确定从哪进入 HF workflow、用户用 /hf-* 命令表达意图、需判断 direct invoke 还是 route-first 的场景。不适用于 runtime 恢复编排（→ hf-workflow-router）、已在 leaf skill 内部（→ 继续当前 skill）。