hx

name	hxflow
description	Harness Workflow — 需求到交付的全自动流水线框架。当用户说 /hx、hx doc、hx plan、hx run、hx go 等触发词时使用。支持需求获取、计划生成、任务执行、质量检查、MR 创建的完整工作流。
compatibility	Requires Bun, or Node.js with npx tsx fallback
metadata	{"generator":"hxflow","version":"4.0.0"}

Harness Workflow

路由

根据 $ARGUMENTS 的第一个词匹配命令，先执行 hx-hook resolve <command> --cwd <用户工作目录> 获取 hooks，再按顺序执行：preHooks → 命令文件 → postHooks（剩余参数原样透传）。

命令	文件	说明
doc	commands/hx-doc.md	获取需求并创建需求文档
plan	commands/hx-plan.md	生成执行计划
run	commands/hx-run.md	执行需求
review	commands/hx-review.md	质量评审
mr	commands/hx-mr.md	创建 Merge Request
go	commands/hx-go.md	全自动流水线
init	commands/hx-init.md	初始化项目
status	commands/hx-status.md	查看任务进度
reset	commands/hx-reset.md	重置需求或计划产物

无参数时默认执行 go。未匹配到命令时提示可用命令列表。

全局规则

• hx-* 系列 npm bin 为运行时脚本入口；通过 --cwd <用户工作目录> 传入用户原始工作目录，在任意 CWD 下均可调用
• hook 解析、脚本路由和运行时回退只在这里定义，各命令文件不重复
• 命令文件只保留 AI 仍可能做错的语义边界，不重复脚本已固化的事实
• 先想清楚再执行：有前提假设就显式写出；存在多种合理解释时，不要静默选一种
• 简单优先：只做完成当前目标所需的最小动作，不预埋额外扩展、抽象或配置
• 外科手术式改动：只改和当前目标直接相关的内容，不顺手重写相邻逻辑
• 目标可验证：步骤和输出要可检查，避免笼统表述

典型流程

init → doc → plan → run → review → mr