用途:Harness Wise 生成或改进“harness”——一种紧凑、可版本化的 Markdown 交接文档,告诉后续规划或编码智能体:目标是什么、哪些项目文档与初始化规则重要、需要读哪些上下文、适用哪些护栏、剩余风险以及如何安全验证。它有两个职责:从项目文档、智能体初始化上下文和任务相关证据创建 harness;在已有 harness 被引用或发现时诊断并改进它。
主要能力与用法:参数包括任务描述或 harness 路径、mode:create|diagnose|auto、harness:<仓库相对路径>、local-only:true|false。默认 mode:auto:提供 harness 路径或存在强候选时诊断,否则创建;默认 local-only:false,将可版本化 harness 写入 docs/harnesses/,除非用户明确要求临时或仅本地输出。开始前需加载 references/safety.md,保持技能标识 krt-harness-wise。仅从文档、初始化文件和窄范围相关证据构建,默认不读整个源码树。源证据为 .pdf 或 .docx 时先用 krt-document-forge,再消费生成的 Markdown。docs/harnesses/sources/、images/、staging/、provenance/ 视为仅本地证据;未提升的暂存摘要不得作为可版本化读取目标,需先校验 sidecar 并确定性提升。提升后的 docs/harnesses/summaries/*.md 归类为 Read First;可版本化 harness 中不得加入原始源、图片、清单、provenance、哈希或暂存路径。涉及客户、商业、内部规划或转换源证据时,先加载 references/publication-safety.md 并脱敏。最终确定前检查 AGENTS.md、本地智能体配置及技能/运行时元数据。置信度高、范围清晰、输出路径明确时直接写入或修补;目标、harness 目标或更新/重生成决策模糊时先问一个聚焦问题。替换前先诊断已有 harness。使用确定性脚本做机械发现与校验,脚本输出作为证据而非语义判断。不要在生成的 harness 中指示下一个智能体调用 krt-harness-wise。写 harness 文件不代表提交、推送、Jira、PR、合并或发布批准。
按需加载:创建新 harness 加载 references/create-harness.md、harness-schema.md、agent-initialization-context.md、context-budget.md;诊断或修补加载 diagnose-harness.md、harness-schema.md、deterministic-validation.md;涉及敏感证据加载 publication-safety.md;使用脚本加载 deterministic-validation.md;验证预期行为加载 validation-scenarios.md。捆绑脚本:scripts/find_agent_init.py、find_harness.py、check_harness.py、check_evidence.py、promote_evidence.py、publication_safety.py。<harness-wise-skill-dir> 解析为包含本 SKILL.md 的目录,安装运行时可能不是仓库检出目录。
工作流:解释请求并选择创建或诊断;按需运行确定性发现;加载流程相关参考;证据含敏感材料时加载 publication-safety.md;转换证据需完成 inspect → classify → redact → promote,要求暂存摘要加 sidecar,运行 check_evidence.py,显式解决警告,再运行 promote_evidence.py;只读提升后的摘要、项目文档、初始化文件和窄范围证据;创建、修补或建议重生成,绝不把被忽略证据复制进 harness;有文件路径时对写入或审查的 harness 运行 check_harness.py;返回 harness 路径/状态、诊断摘要、校验与提升结果、发布安全状态及待定验证。
输出纪律:创建或更新文件时报告 harness 路径、状态(draft/ready/blocked/review)、使用的初始化上下文、校验结果、发布安全结果、剩余阻塞问题或待定验证;仅诊断输出时先给发现与结论。
限制:不实现应用改动、不写测试、不编辑迁移、不改部署配置、不创建通用项目文档、不提交、不推送、不开 PR、不修改外部系统。