用途:by-harness 是一个独立 skill,用于给目标仓库安装并运行稳定的工程闭环:read task -> plan -> build -> qa -> fix -> mark_pass -> session_close。核心目标是让每次开发都有明确任务来源、规格、实现边界、验收方式与会话收口记录。
主要能力:初始化 harness 工作区(AGENTS.md、CLAUDE.md、.harness/config、docs、scripts、task-harness 等,生成任务索引 .harness/task-harness/index.json);持续拆任务;按任务闭环执行;quick-fix/fast-track 快速分流;会话收口与续跑;老仓库版本化升级;下发 Java 工程总门禁与分布式 Java 门禁规范。
使用方式:初始化运行 python3 {{SKILL_PATH}}/scripts/scaffold.py --project-name "..." --target-dir "...",随后执行 bash .harness/scripts/init.sh;拆任务运行 scripts/decompose_tasks.py;快速改动先运行 .harness/scripts/quick_fix_classifier.py 分类;收口运行 .harness/scripts/session_close.py;续跑运行 .harness/scripts/task_switch.py continue --target-dir .;升级运行 scripts/update_runtime.py,需快照时显式传 --backup。
任务存储:默认 v3 单任务文件,任务写入 .harness/task-harness/tasks/,进度写入 progress/YYYY-MM/,日常定位优先用 display_id(如 B001-T001)。
限制:quick-fix/fast-track 只写进度日志,不得修改任务定义或把 feature passes 置为 true;不涉及 DB migration、权限安全、计费、限流、缓存一致性、事务、幂等、外部 API、公共 DTO 或接口契约。初始化不用 --force,除非用户明确要求覆盖。已有 AGENTS.md/CLAUDE.md 时只合并托管区块。passes=true 需单测、QA Gate、Agent Review 通过且 spec/contract 已落盘。三个固定下限规则必须遵守。具体版本号、收费与平台信息暂未提供。