# Harness Accept > Generate an Acceptance Demo HTML for non-engineer vibecoders right before ship/wait/reject decision. Reads back the acceptance_criteria that were stored as personal-preference.v1 by harness-plan-brief (joined by user_request_hash), then renders a single-file HTML showing each criterion as verified or unverified along with a ship/wait/reject recommendation. Use when the user asks for an acceptance review, wants to decide whether to ship a delivered task, or says: acceptance demo, accept demo, 受け入れ判断, 受入レビュー, ship/wait/reject 判定, 検収レビュー. Do NOT load for: implementation, code review, release work. - Skill: `chachamaru127/harness-accept` (Agent Skill, multi-file: 3 files) - Install (CLI): `npx skillmds@latest add chachamaru127/harness-accept` - Raw SKILL.md: https://api.skillmd.com/api/skills/chachamaru127/harness-accept/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Web & Frontend - Author: Chachamaru127 (https://skillmd.com/u/chachamaru127) - Updated: 2026-09-10 - Page: https://skillmd.com/skills/chachamaru127/harness-accept --- # harness-accept 非エンジニアの発注者・プロデューサー職向けに、実装完了タスクの受け入れ判断 (ship / wait / reject) を **HTML 1 枚** で提示するスキル。 発注者の認知負荷ピーク (3) 受け入れ判断の段階で使う。 Phase 65.1.x (`harness-plan-brief`) の対構造として動作し、Plan Brief で承認した `acceptance_criteria` を read 側で取り戻して評価する。 ## Quick Reference - 「**Acceptance Demo を作って**」 → このスキル - 「**受け入れ判断したい**」 → このスキル - 「**ship/wait/reject 判定**」 → このスキル ## 責任境界 | 範囲 | このスキルの責務 | |------|-----------------| | 検索 | **現プロジェクトのみ** (`project: `, `strict_project: true` を必ず指定) | | クロスプロジェクト | **やらない** (Phase 65.3 以降で `--cross-project-group ` flag で opt-in 解放) | | Plan Brief 連携 | `user_request_hash` を join key として `personal-preference.v1` (Phase 65.1.4) を read | | 書き込み | やらない (Acceptance 承認後の memory write は `accept-record-decision.sh` の責務) | | recommendation 算出 | verified / 全 criteria の比率で 0.8 / 0.5 閾値判定。ロジックは `scripts/render-html.sh` 直前で計算 | ## 入力 引数 `[task-description]` にユーザーの request を渡す (Plan Brief 時と同じ文を使う)。 引数なしの場合は会話と Plan Brief の原依頼を読み取りで回収する。hash の照合に使うため原文を言い換えない。対象が確定しない時だけ確認する。 ## 出力 | 出力 | パス | 形式 | |------|------|------| | Acceptance Demo HTML | `.claude/state/views/accept-.html` | 単独で開ける HTML (no server, no JS framework) | | Acceptance context JSON | `.claude/state/views/accept-.context.json` | `acceptance-context.v1` schema | ## Schema: `acceptance-context.v1` ```json { "schema": "acceptance-context.v1", "user_request": "string", "user_request_hash": "sha256 hex (Plan Brief 側の personal-preference.v1 と join)", "demo_artifacts": [ { "kind": "video|screenshot|text", "path": "string" } ], "verified_criteria": [ { "name": "string", "passed": true, "evidence": "string" } ], "tdd_verified": "yes|no|not-required|skip:", "unverified_caveats": ["string"], "past_issue_patterns": [ { "pattern_id": "P5", "title": "string", "verified_in_current_task": true } ], "recommendation": "ship|wait|reject", "recommendation_evidence": ["string"], "project": "string", "generated_at": "ISO8601", "blind_evaluation": { "applicable": true, "eligibility_reason": "persuasive-doc|functional-skip|not_applicable|unavailable", "audience_purpose_line": "string", "evaluator_believable": "believable|not_believable|uncertain", "evaluator_useful": "useful|not_useful|uncertain", "evaluator_friction_points": ["string"], "internal_recommendation": "ship|wait|reject", "divergence": "none|internal_high_evaluator_low|internal_low_evaluator_high", "divergence_notes": "string" } } ``` `blind_evaluation` は Phase 137.2 で追加した optional field (additive、既存 consumer は無視してよい)。 詳細は [`references/blind-evaluator.md`](${CLAUDE_SKILL_DIR}/references/blind-evaluator.md) を参照。 完全 schema は [`schemas/acceptance-context.v1.schema.json`](${CLAUDE_SKILL_DIR}/schemas/acceptance-context.v1.schema.json) を参照。 ## Recommendation 算出ロジック ``` verified_count = count of verified_criteria where passed=true total_criteria = count of verified_criteria pending_count = count of criteria whose evidence が "pending_validations: " prefix を持つ (Step 4 の記入規約) ratio = verified_count / total_criteria (total=0 のときは 0) total = 0 → "reject" (criteria 0 件は判定不能、安全側 reject) ratio >= 0.8 → base = "ship" ratio >= 0.5 → base = "wait" ratio < 0.5 → base = "reject" # pending 補正 (Phase 134.4): 検証待ちの criteria が残っている限り ship にしない pending_count >= 1 かつ base == "ship" → interim = "wait" (ship から丸める) それ以外 → interim = base # blind_evaluation 補正 (Phase 137.2): fresh fork 評価者が「信じられない/役に立たない」と # 判定し、かつ内側の recommendation が依然 ship なら wait に丸める。reject へはさらに丸めない blind_evaluation.applicable == true かつ blind_evaluation.divergence == "internal_high_evaluator_low" かつ interim == "ship" → recommendation = "wait" それ以外 → recommendation = interim ``` 評価根拠は `recommendation_evidence` に literal な数値で残す。 例: `"verified 4 件 / 全 5 件 (80%) → ship 閾値以上"` pending 補正が効いた場合は `"pending_validations 該当 criteria N 件が未解消のため ship を wait に丸めた"` のように理由を明記する。 blind_evaluation 補正が効いた場合は `"blind evaluator が believable=not_believable / useful=not_useful と判定したため ship を wait に丸めた"` のように理由を明記する。 アルゴリズムと Eligibility (説得系/文書系のみ適用、機能系は `functional-skip` で skip) の詳細は [`references/blind-evaluator.md`](${CLAUDE_SKILL_DIR}/references/blind-evaluator.md) 参照。 ## Execution Flow スキル起動時、Claude は以下の手順で動作する。 ### Step 1: project name と user_request_hash を解決 ```bash PROJECT_NAME="$(basename "$(git rev-parse --show-toplevel)")" USER_REQUEST_HASH="$(printf '%s' "$USER_REQUEST" | sha256sum | awk '{print $1}')" ``` `PROJECT_NAME` が空 (git 外) の場合は `current` をデフォルトに使う。 ### Step 2: harness-mem を **project-only** で検索し、Plan Brief 側 record を取得 (default) 引数に `--cross-project-group ` flag が**ない**場合 (default behavior): `mcp__harness__harness_mem_search` を以下のパラメータで呼び出す: ``` project: strict_project: true tags: ["personal-preference", "plan-brief-approval"] limit: 10 ``` > **重要**: `project` パラメータは**必須**。`strict_project: true` を指定し、cross-project な検索は**絶対に行わない**。 取得した record を `data.user_request_hash == ` でフィルタし、最も新しい 1 件を選ぶ。 これが Plan Brief 時の承認内容 (chosen_option / acceptance_criteria 等) を保持している。 ### Step 2 (alt): cross-project search (Phase 65.3.5 opt-in) 引数に `--cross-project-group ` flag が**ある**場合のみ、横断 group 内の他プロジェクトでの 類似 plan-brief-approval / acceptance-decision 履歴を取得する (D43 Option α): ```bash MEMBERS_JSON="$(bash scripts/load-cross-project-groups.sh --group "" 2>/dev/null)" || { echo "ERROR: cross-project group not found: " >&2 exit 1 } ``` `MEMBERS_JSON` が `[]` の場合は default の単一 project search に fallback。 `MEMBERS_JSON` が非空の場合、各 member project ごとに MCP search を 1 回発行: ``` for each project in MEMBERS_JSON: mcp__harness__harness_mem_search( project: , strict_project: true, tags: ["personal-preference", "plan-brief-approval"], limit: 10 ) ``` 結果を client 側でマージし、`data.user_request_hash == ` でフィルタ。 hash 一致は基本的に同一 user request 由来のため複数 project での重複は稀だが、念のため id 単位で dedupe。 cross-project 由来の record を採用すると過去他案件の chosen_option / acceptance_criteria が混入する 可能性があるため、HTML 出力時は **`--with-redaction` flag を必ず使用** すること: ```bash bash scripts/render-html.sh --template accept ... --with-redaction ``` 詳細は `.claude/rules/cross-repo-handoff.md` の「Phase 65.3 実装決定事項 (D43)」を参照。 ### Step 3: 過去の問題パターンを取得 (Phase 65.2.2 委譲) ```bash bash scripts/accept-past-issues.sh --project "$PROJECT_NAME" --task "$USER_REQUEST" > "$PAST_ISSUES_JSON" ``` このスクリプトは patterns.md (P1-P33) と過去の `acceptance-context.v1` record を semantic search し、 最大 3 件の `past-issue.v1` を返す。各々 `verified_in_current_task: bool` 付き。 ### Step 4: verified_criteria を artifact から組み立てる (Phase 134.4) まず `scripts/accept-collect-evidence.sh ` (read-only) を実行し、`accept-evidence.v1` を取得する: ```bash EVIDENCE_JSON="$(bash scripts/accept-collect-evidence.sh "$TASK_ID")" ``` これは 4 artifact (`.claude/state/review/.worker-report.json` / `.claude/state/review-result.json` [`task.id` 一致時のみ採用] / `.runtime-review.json` / `.browser-result.json`) を読み、 各 artifact の `present` / `reason` / `data` と `pending_validations` (Reviewer が積んだ未解消レイヤー) を正規化して返す。 **原則: artifact から引用する。新規主張を作らない。** Plan Brief 時の acceptance_criteria 各項目について、 `EVIDENCE_JSON` の 4 artifact の中から該当する記述を探し、その内容を `evidence` にそのまま転記する。 Claude が artifact に無い「動作確認した」を独自に主張することは禁止。 Worker の「完了した」という自己申告だけでは criterion を合格にしない。対象 task と現在の成果物に対応するコマンド結果、実測、参照箇所があるか確認する。 この評価のために勝手に実装や公開へ進まず、不足する証拠は未検証として残す。 各 criterion の判定: - artifact 内に該当する検証結果があり合格 → `passed: true`、`evidence` に artifact の該当箇所を引用する - 該当 artifact が欠損 (`present: false`) か、`EVIDENCE_JSON.pending_validations` に該当 layer がある場合 → `passed: false`。 `evidence` には次の literal prefix で実状態を転記する (pending_count の機械カウントに使う規約): - pending 由来: `"pending_validations: " + <該当 pending_validations[].reason>` - artifact 欠損由来: `"artifact missing: " + + " (" + + ")"` - 上記いずれの場合も、同じ内容を `unverified_caveats` に 1 行追記する `evidence` が空文字列の場合、HTML 上で警告表示される (DoD c、既存動作)。 **demo_artifacts への video 合流 (Phase 134.6)**: `EVIDENCE_JSON.demo_artifacts` (browser-review-runner.sh が拾った playwright screencast の `{kind:"video", path}`) を、コンテキスト JSON の `demo_artifacts` 配列に 追記する。ただし `path` はプロジェクトルート相対のまま転記してはならない — 出力先 HTML は `.claude/state/views/accept-.html` にあり、`