From harness-flow
Routes HF workflows at runtime by analyzing artifacts to determine current node, profile, execution mode, branches like hotfix/increment, and review dispatch. Use on 'continue/advance', post-review recovery, conflicts, or unclear stages.
npx claudepluginhub hujianbest/harness-flow --plugin harness-flowThis skill uses the workspace's default tool permissions.
HF workflow family 的 **runtime authority**。负责根据最新证据决定:Workflow Profile、Execution Mode、Workspace Isolation、canonical 节点、是否切支线、review dispatch、恢复编排。
evals/README.mdevals/evals.jsonreferences/execution-semantics.mdreferences/profile-node-and-transition-map.mdreferences/profile-selection-guide.mdreferences/review-dispatch-protocol.mdreferences/reviewer-return-contract.mdreferences/routing-evidence-examples.mdreferences/routing-evidence-guide.mdreferences/ui-surface-activation.mdreferences/workflow-shared-conventions.mdtest-prompts.jsonRoutes HF workflows by deciding direct leaf skill invocation versus route-first to hf-workflow-router for new sessions, /hf-* commands, and uncertain entry points.
Routes development tasks to express/standard/deep workflow agents via complexity analysis or --workflow param. Preprocesses args, inits env with bash/pwsh scripts, detects/resumes state. Triggers: /routing.
Share bugs, ideas, or general feedback.
HF workflow family 的 runtime authority。负责根据最新证据决定:Workflow Profile、Execution Mode、Workspace Isolation、canonical 节点、是否切支线、review dispatch、恢复编排。
using-hf-workflow 负责 public entry / family discovery;本 skill 负责 runtime routing / recovery。
本 skill 融合以下已验证方法。每个方法在 Workflow 中有对应的落地步骤。
| 方法 | 核心原则 | 来源 | 落地步骤 |
|---|---|---|---|
| Finite State Machine (FSM) Routing | 将 workflow 阶段建模为有限状态机,每条转移边由工件状态证据驱动 | 项目化实践(工作流路由通用方法) | 步骤 7 — 决定 canonical 节点 |
| Evidence-Based Decision Making | 所有路由判断基于磁盘工件证据(而非聊天记忆),对证据冲突采用保守策略 | 项目化实践(HF 核心约定) | 步骤 2 — 读取证据;步骤 6 — 归一化 handoff |
| Escalation Pattern | Profile 升级遵循渐进增强——从 lightweight 到 standard 到 full | 项目化实践(渐进增强策略) | 步骤 4 — 决定 Workflow Profile |
适用:
hf-hotfix 或 hf-increment不适用 → 先走 using-hf-workflow:
/hf-* 意图Direct invoke 信号:reviewer 返回 reroute_via_router=true、证据冲突需权威路由。
| 场景 | 用 hf-workflow-router | 不用 |
|---|---|---|
| runtime 恢复编排、profile/mode 判断 | ✅ | |
| 新会话 family discovery | → using-hf-workflow | |
| 具体节点的作者/评审/实现工作 | → 对应 leaf skill | |
| 具体节点的评审 | → 对应 review skill |
若是 public entry discovery → 回到 using-hf-workflow。否则(恢复编排、profile 判断、消费 review/gate 结论、evidence conflict、切支线)继续。
只读路由所需的最少内容:项目级路径约定(若项目已声明)、用户请求、工件状态、顶层导航(档 2 优先 docs/index.md,档 0/1 用仓库根 README.md,缺失时扫 features/ 兜底)、features/<active>/progress.md、features/<active>/reviews/ 与 features/<active>/verification/ 等 review/verification artifacts。不先做大范围代码探索。read-on-presence:docs/ 中未启用的可选资产缺失不阻塞路由。证据冲突时按未批准处理、选择更上游节点、必要时升级 profile。
优先于普通主链推进:紧急缺陷修复 → hf-hotfix;需求变更/范围调整 → hf-increment。
由 router 决定,不允许下游自行声称。
| Profile | 适用场景 |
|---|---|
full | 无已批准规格/设计、架构/接口/数据模型变化、高风险模块 |
standard | 已批准规格+设计,中等复杂度扩展或 bugfix |
lightweight | 纯文档/配置/样式变化,或低风险单文件 bugfix |
判定:先执行 项目级强制规则(若项目已声明) → 沿用已有 profile → 按证据选择 → 冲突选更重。只允许升级,不允许降级。
详细规则:references/profile-selection-guide.md
进入 design stage 时,router 还需判断是否激活 hf-ui-design 这个 conditional peer skill。
| 证据 | 决策 |
|---|---|
| 规格声明 UI surface / 可见页面 / 交互 / UX NFR / a11y / i18n / 响应式 | 激活 hf-ui-design,与 hf-design 并行 |
| 规格为 API-only / 脚本 / CLI / 数据管道 / 纯后端 | 不激活,design stage 只走 hf-design 单节点 |
| 规格含糊或证据冲突 | 回 hf-specify 补齐 UI surface 声明,不自行判定 |
激活后按 Design Execution Mode(parallel / architecture-first / ui-first)决定起草顺序;默认 parallel。此字段与 Execution Mode(interactive / auto)正交,不混写。
详细规则:references/ui-surface-activation.md
与 Profile 正交,不混写成复合值。归一化顺序:用户显式要求 → 项目级默认 → 已有值 → 默认 interactive。
interactive:approval step 等待用户auto:按 policy 写 approval record 后自动继续auto 不删除 review、gate 或 approval 节点详细规则:references/execution-semantics.md
可选 coordination state。读取 feature progress.md(默认 features/<active>/progress.md)已有值 + 项目约定 + 当前请求类型。
决策:已有 worktree-active 且路径一致 → 沿用;进入 hf-test-driven-dev 且命中 full/standard/代码修改/脏状态 → worktree-required;仅 lightweight+干净 → in-place。不静默降级。
参考:hf-test-driven-dev/references/worktree-isolation.md(实现侧权威指南);若 项目声明项目等价路径,优先遵循。要点摘要:Workspace Isolation ∈ in-place / worktree-required / worktree-active;worktree-required 必须在进入实现前完成 worktree provisioning;worktree-active 下游节点必须复用 Worktree Path,不得静默退回主工作区;review dispatch 携带 Worktree Path / Worktree Branch;closeout 不擅自删除 worktree,只记录 disposition。
Next Action Or Recommended Skill 是受控字段。若已有显式 handoff:检查能否归一化 → 是否与最新 evidence 一致 → 是否在当前 profile 合法集合内。全部满足才采用;否则忽略,回退到迁移表。
路由原则:支线优先于主链 → review/gate 恢复优先于实现 → 缺失上游优先于下游 → 冲突选更保守 → task reselection 优先于 finalize。
迁移表:references/profile-node-and-transition-map.md
若结论无法映射到唯一节点,重新路由,不自行补脑。
读取最新结论 → 确认 Profile/Mode → 检查 handoff → 按 router authority 判定。
关键分支:
conclusion=通过 + needs_human_confirmation=true:interactive 等待/auto 写 record 再继续hf-test-driven-dev;无剩余 task → hf-finalize;候选不唯一 → hard stop参考:references/review-dispatch-protocol.md、references/reviewer-return-contract.md
不在父会话内联 review。构造最小 review request,带入 Workspace Isolation 上下文,派发独立 subagent,消费结构化 summary。
路由结论不是独立用户交互:非暂停点 → 同一轮进入目标 skill;review 节点 → 立刻派发;approval step → 按 Mode 处理;task reselection → 同一轮继续。只有 hard stop 才等待。
参考:references/execution-semantics.md
最小输出:Current Stage、Workflow Profile、Execution Mode、Workspace Isolation、Target Skill。Evidence 足够时用紧凑格式(加 1-2 条决定性 Why)。不回放未命中分支、不复述 authority 说明。
runtime canonical 写法统一:hf-workflow-router、reroute_via_router。
using-hf-workflow 写进 runtime handoffauto 理解成"不写 approval record"| 文件 | 用途 |
|---|---|
references/profile-selection-guide.md | Profile 判定详细规则 |
references/profile-node-and-transition-map.md | 各 profile 合法节点与迁移表 |
references/execution-semantics.md | Execution Mode、暂停点、连续执行 |
references/review-dispatch-protocol.md | reviewer subagent 派发协议 |
references/reviewer-return-contract.md | reviewer 返回结果契约 |
references/routing-evidence-guide.md | 路由证据收集指南 |
references/routing-evidence-examples.md | 路由判定示例 |
references/ui-surface-activation.md | UI surface 激活条件、Design Execution Mode、联合 design approval 规则 |
hf-workflow-router 与 reroute_via_router