SuperAPI AI 工具集

harness-plan-brief

编程与开发

查看项目

更新于 10-15 17:33

技能介绍

用途:harness-plan-brief 是 chachamaru127/claude-code-harness 中的技能,面向非工程师的发注者、制作人角色,在 Claude 着手实现之前,用一张可独立打开的 HTML 呈现计划,供其确认理解是否正确。触发说法包括「Plan Brief を作って」「実装前にざっくり整理」「非エンジニア向けに計画を見せて」。

主要能力:仅检索当前项目(project: <current>、strict_project: true),从 harness-mem 的过去 decision、pattern、Plans archive 中取最多 5 条相似案例;生成 Plan Brief HTML 与 plan-brief-context.v1 schema 的 context JSON;输出 options、risks、acceptance_criteria(各至少 1 条);显示一行 TDD 判定(yes / no / skip:<reason>)。confidence 为兼容字段,实际含义限定为 plan_readiness,即 DoD 明确度与依赖解决率两项,不表示 AI 理解度或成功概率。

使用方式:技能按步骤执行——解析项目名(git rev-parse --show-toplevel 的 basename,失败则用 current);调用 mcp__harness__harness_mem_search(project、strict_project: true、query、expand_links: true、limit: 5);用 scripts/plan-brief-compile.sh 组装 context JSON;用 scripts/render-html.sh --template plan-brief --data "$CONTEXT_JSON" --out "$HTML_OUT" 渲染;用 scripts/plan-brief-open.sh 打开浏览器(BROWSER=true 时跳过打开,仅输出路径);最后等待用户批准。跨项目检索需显式加 --cross-project-group <name>,按 D43 对每个成员项目各发一次 MCP 调用并在客户端合并去重,且渲染时须加 --with-redaction。

输出:HTML 位于 .claude/state/views/plan-brief-<timestamp>.html,context JSON 位于同目录 .context.json。

限制:本技能不写入记忆,批准后的 memory write 由 plan-brief-record-decision.sh 负责;默认不做跨项目检索;mem search 不可达时以空数组继续;render-html.sh 失败则 exit 1;open 失败仅输出路径并 exit 0。具体安装命令与收费信息暂未提供。