菜单
HarnessFlow frame 阶段(主链入口)。任何新特性、行为变更或缺陷修复开始时使用:把用户意图定格为一页 frame.md——意图、范围、风险档位(1 微改/2 标准/3 高危)及理由,并用 hf_gate.py run 建立环境基线(全量测试/构建能否真实运行)。不写需求细节、不做设计。产出的档位决定后续流程形态。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
C++ 编程规范扩展。绑定阶段: build。触发条件: 项目主要语言为 C++(存在 CMakeLists.txt / *.cpp 主体代码)。约束 C++ 项目在实现阶段的测试组织(GoogleTest)、资源管理与常见测试反模式。
UI 设计领域扩展。绑定阶段: plan、build、verify。触发条件: 特性包含用户界面(页面、组件、可视交互)。为计划阶段追加 UI 设计章节要求(信息架构、交互状态、design token、可访问性),为实现与验证阶段追加前端验收纪律(交互三态测试、真实渲染冒烟证据)。
HarnessFlow build 阶段(TDD)。计划已批准(或档位 1 的 frame 已完成)、任务清单存在未完成任务时使用,也用于代码评审返回"需修改"后的修订。以红-绿-重构循环逐个完成任务,每次测试运行都必须通过 hf_gate.py run 落盘为证据日志。gate check --to build 未通过时不得使用,先回上游。
HarnessFlow plan 阶段。frame 完成且风险档位 ≥2 时使用:档位 2 产出一份 plan.md(需求+设计+任务清单),档位 3 先产出 spec.md 评审通过后再产出 design.md。也用于 plan 层评审返回"需修改"后的修订。档位 1 不使用本技能。前提不满足(gate check --to plan 失败)时回 hf-frame。
HarnessFlow 独立评审。plan 层工件(plan.md / spec.md / design.md)与实现代码完成后,必须经本技能给出落盘的评审结论才能推进。核心纪律:评审只承认 subagent 或全新会话,主会话冷读是降级路径且不得自我确认;代码评审者必须自己跑测试、自己读 diff。不修改被评审对象,只产出结论与 findings。
HarnessFlow ship 阶段。verify 完成(gate check --to ship 通过)后使用:逐条对照需求验收闭环、同步文档、收尾状态并向用户交付总结报告。gate check --to ship 未通过时不得使用。
| name | hf-frame |
| description | HarnessFlow frame 阶段(主链入口)。任何新特性、行为变更或缺陷修复开始时使用:把用户意图定格为一页 frame.md——意图、范围、风险档位(1 微改/2 标准/3 高危)及理由,并用 hf_gate.py run 建立环境基线(全量测试/构建能否真实运行)。不写需求细节、不做设计。产出的档位决定后续流程形态。 |
目标:回答三个问题——要做什么(一句话意图与范围)、多危险(风险档位)、这个项目我能验证吗(环境基线)。frame 是唯一没有独立评审的阶段,所以它只允许装低成本、可被后续评审推翻的决定;拿不准的一律往高档靠。
读用户请求与相关既有代码。取 features/ 下一个编号创建 features/<NNN>-<slug>/ 与 progress.md(格式见 hf-workflow)。把意图压缩成一句话;会改变范围或验收标准的阻塞性未知项,合并成尽量少的轮次一次问清,不逐条追问;可合理假设的次要项写入 frame.md 假设区,标注"如不对请指出"。
对照判据,从高往低判,任一命中即入该档:
| 档位 | 判据(任一命中) |
|---|---|
| 3 高危 | 数据迁移/删除;认证、授权、支付等安全面;跨 ≥3 模块的结构调整;破坏公共 API 或存储格式;不可逆操作 |
| 2 标准 | 新功能、行为变更、非平凡缺陷修复;默认档 |
| 1 微改 | 单点小改(典型 ≤2 个文件),行为边界清晰,可逆,不碰数据/安全/公共接口 |
档位理由必须落盘,可被冷读检验。档位由后续评审复核:档位 2/3 在 plan 层评审复核,档位 1 在代码评审复核(diff 与档位不符即严重 finding,升档重走)。
用机械门禁真实运行项目的全量测试(或构建):
python3 skills/hf-workflow/scripts/hf_gate.py run \
--feature features/<NNN>-<slug> --label baseline -- <全量测试命令>
# <特性名> Frame
- 日期: YYYY-MM-DD
- 意图: <一句话:为谁改什么、改到什么程度算完成>
- 范围外: <明确不做的;无则写"无">
- 风险档位: 1|2|3
- 档位理由: <对照判据,可被冷读检验>
- 环境基线: evidence/baseline-<ts>.log (exit <N>)
- 基线说明: <跑了什么命令;失败时的恢复计划>
- 假设: <未经确认的合理假设;无则写"无">
gate check --to plan,PASS 后进 hf-plan。gate check --to build,PASS 后直接进 hf-build。