Skip to main content Início Criadores whyzsm tiny-agents harness-review
harness-review HAR: Multi-angle code, plan, scope review. Security/quality check. Trigger: review, code review, plan review, scope analysis. Do NOT load for: implementation, new features, bugfix, setup, release.
Ir para a instalação Skills Marketplace Descubra e explore skills de IA criadas pela comunidade.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Mostrar detalhes do prompt Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.
npx skills add https://github.com/whyzsm/tiny-agents --skill harness-reviewO comando permanece em uma só linha. Role horizontalmente para revisá-lo antes de copiar.
Prefere uma cópia local? Baixe os arquivos disponíveis atualmente no SkillsMP.
Baixar Zip Baixando... Mais deste repositório tech-tmax-backend-architect-team Single-Agent T-MAX Java backend architecture and engineering rule package. Use when Codex must design, implement, review, or diagnose T-MAX backend services involving Java 8, Spring Boot, Kylin, MyBatis XML, TiDB/MySQL, Apollo/Nacos, Feign, AnePageHelper, ResponseResult/DataGridResult, UEP export, Redis, RabbitMQ, or Maven multi-module repositories. Routes one Agent through repository intake, architecture decisions, API/data contracts, implementation diagnosis, quality/security review, and bounded evidence loops while keeping builds, tests, live calls, commits, and pushes as separate authority boundaries.
Create polished consulting-style single-file HTML research reports from messy business notes, screenshots, metrics, and iterative user feedback. Use this skill whenever the user asks for a 咨询风/艾瑞咨询风/研究报告/汇报报告/HTML报告, wants business or AI landing-practice material turned into a management-facing report, asks to add charts/diagrams, or asks to update report metrics and keep the whole HTML report consistent.
harmonyos-app-store-self-check Audit HarmonyOS applications for AppGallery/AGC release readiness, including Huawei UX/HMI controls, system-feature integrations, and performance gates for multi-input interaction, latency, frame rate, content display, memory, and CPU. Use when users ask for 鸿蒙上架自检、应用市场审核、AGC发布前检查、控件/系统特性/人机交互/签名/隐私/权限/截图/性能核对或 release 包门禁, especially for Stage-model projects with module.json5, build-profile.json5, hvigorw, and local-first data constraints.
Ocupações relacionadas SOC
Baseado na classificação ocupacional SOC
Explorador de arquivos
13 arquivos name harness-review description HAR: Multi-angle code, plan, scope review. Security/quality check. Trigger: review, code review, plan review, scope analysis. Do NOT load for: implementation, new features, bugfix, setup, release. description-en HAR: Multi-angle code, plan, scope review. Security/quality check. Trigger: review, code review, plan review, scope analysis. Do NOT load for: implementation, new features, bugfix, setup, release. description-ja HAR:コード・プラン・スコープを多角的にレビュー。セキュリティ・品質チェック。レビューして、レビュー、コードレビュー、プランレビュー、スコープ分析で起動。実装・新機能・バグ修正・セットアップ・リリースには使わない。 kind workflow purpose Review code, plans, scope, and evidence before acceptance trigger review, レビューして, code review, plan review, scope analysis shape evaluate role evaluator pair harness-work owner harness-core since 2026-05-05 allowed-tools ["Read","Grep","Glob","Bash","Task","Monitor","AskUserQuestion"] argument-hint [code|plan|scope|--quick|--codex-closeout|--dual|--team-debate|--security|--ui-rubric] context fork effort high user-invocable true
Harness Review
Harness の統合レビュースキル。
この SKILL.md は薄い dispatcher であり、詳細な品質基準は references/ を読む。
if $ARGUMENTS == "":
→ 「今までの作業のレビュー」と解釈し、Review target detection を実行する
→ review target が 1 つに確定できる場合だけ自動開始する
→ review target が不明または複数候補の場合は AskUserQuestion で選択肢を出し、認識を揃えてから開始する
Output Contract (P35: 「止まったように見える」UX 対策)
skill 結論時の output の 最後の 1 行 は必ず P35 footer を含め、footer は本文 (user-facing prose) と同じ言語で出力する（言語解決は既存の言語ルールに従い、footer 契約は言語を再定義しない）。これは <local-command-stdout> 経由の表示で user が「止まった」と感じる UX 問題への明示的な instruction (patterns.md P35) で、意図は言語に依存しないため literal は言語ごとに切り替える (#208):
ja: ↑この結果は Claude が要約します。Enter キーで次へ進むか、新規 prompt で別の指示を出してください。
en: ↑Claude will summarize this result. Press Enter to continue, or send a new prompt for a different instruction.
その他の言語: 同じ意味の 1 行を本文と同じ言語で出力する
Dispatcher Contract
この skill の責務は review 判定だけ。
commit / push / release は既定では行わない。
review default read-only boundary: 既定は read-only。APPROVE でも自動 commit しない
Do not push just to review: review 目的だけで push しない
commit が必要な場合は、ユーザー明示依頼、harness-work、または harness-release の Work Commit Gate に委譲する
--commit-on-approve のような明示 opt-in が設計されるまで、この skill 単体の default side effect は禁止
Quick Reference
Command Mode Purpose /harness-reviewcode今までの作業を自動検出して review /harness-review --quickquick小さな dirty change を軽く closeout /harness-review --codex-closeoutcodex-closeoutCodex 助言 + focused tests で closeout /harness-review --dualdualClaude + Codex second opinion /harness-review --cursorcode+cursor-second-opinioncore review gates に cursor (composer-2.5-fast) second-opinion を加算 (read = lean、Opus reviewer 必須併走) HARNESS_IMPL_BACKEND=cursor harness-review
code+cursor-second-opinion
default ON 時も core review gates に cursor second-opinion を自動加算。primary verdict は Opus/brain 固定
/harness-review --team-debateteam-debateTeamAgent Debate を強制
/harness-review --securitysecuritysecurity 専用 review
/harness-review planplanPlans.md の計画 review
/harness-review scopescopescope creep / 漏れ review
Mode Decision 引数から実行 mode を決定し、必要な references/ を選択ロードする。
入力 mode 読む reference 引数なし / code codereferences/code-review.md, references/governance.md--quickquickreferences/codex-closeout.md, references/code-review.md--codex-closeoutcodex-closeoutreferences/codex-closeout.md--dualdualreferences/dual-review.md, references/team-debate.md--team-debateteam-debatereferences/team-debate.md, references/governance.md--securitysecurityreferences/security-profile.md, references/governance.md--ui-rubricui-rubricreferences/ui-rubric.mdplanplanreferences/plan-review.md, references/governance.mdscopescopereferences/scope-review.md, references/governance.md--cursor or resolver result cursor for no-arg / code review onlycode+cursor-second-opinionreferences/code-review.md, references/governance.md, references/cursor-review.md, references/dual-review.mdfullfullreferences/code-review.md, references/team-debate.md, references/dual-review.md
quick と codex-closeout は軽量 path。
小さな dirty change、single commit、PR branch の closeout を速く見る。
品質 gate を捨てるものではない。
Cursor Default ON mode 判定時、明示 mode words (plan, scope, full) と明示フラグを先に確定する。no-arg / code review の場合だけ helper root を解決して resolver を 1 回だけ実行し、resolver 不在時は claude とみなす。
HARNESS_PLUGIN_ROOT="${HARNESS_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-} } " ; if [ -z "$HARNESS_PLUGIN_ROOT " ] && [ -n "${CLAUDE_SKILL_DIR:-} " ]; then probe="$(cd "${CLAUDE_SKILL_DIR} " && pwd) " ; while [ "$probe " != "/" ] && [ ! -d "$probe /scripts" ]; do probe="$(cd "$probe /.." && pwd) " ; done ; [ -d "$probe /scripts" ] && HARNESS_PLUGIN_ROOT="$probe " ; fi
if [ -x "${HARNESS_PLUGIN_ROOT:-} /scripts/resolve-impl-backend.sh" ]; then resolved_backend="$(bash "${HARNESS_PLUGIN_ROOT} /scripts/resolve-impl-backend.sh" --role reviewer) " ; else resolved_backend="claude" ; fi
no-arg / code review で結果が cursor の場合は --cursor と同じ cursor-second-opinion を追加するが、core review gates (references/code-review.md, references/governance.md) は必ず先に読み、Cursor reference は additive にだけ扱う。primary verdict は Opus/brain 側で維持し、cursor は dual_review.cursor_verdict の advisory に限る。plan / scope など明示 mode word は resolver result より優先し、cursor default によって plan/scope references も code/governance references も置き換えない。
結果が claude / codex の場合は従来どおりで、review の primary 判定面は変えない。
Review Target Detection REVIEW_AUTOSTART 契約:
引数なし ($ARGUMENTS == "") で呼ばれた場合、review / /review / /harness-review だけの入力を「今までの作業のレビュー」と解釈する。
Step 1 開始前の handshake 行として次を 1 行だけ出力する。
REVIEW_AUTOSTART: target={resolved_target}, base_ref={resolved_base_ref}, type={mode}
REVIEW_TARGET_ASK 契約:
bare 呼び出しで review target が不明または複数候補の場合、Step 1 に進む前に AskUserQuestion を 1 回だけ使い、候補を 2-3 個に絞って確認する。
候補は 1. working tree（未コミット変更のみ）、2. branch range（upstream または main/master から HEAD）、3. recent commits（clean tree 時の直近 1 commit / 直近 5 commits）の順で作る
複数候補が同時に成立する場合は REVIEW_TARGET_AMBIGUOUS: working_tree_and_branch_commits、clean tree かつ branch 差分がない場合は REVIEW_TARGET_AMBIGUOUS: clean_tree_no_branch_commits を 1 行出力してから AskUserQuestion を出す
ユーザー回答後は REVIEW_TARGET_CONFIRMED: {choice} に続けて REVIEW_AUTOSTART 行を出力する
AskUserQuestion の選択肢 literal・推奨 (Recommended) の付け方・各候補の比較範囲は references/code-review.md の Target Selection 節に従う
「タスクが不明確です」と応答して停止する
「何をレビューすればよいですか」と自由記述で聞いて停止する
host project の session-start rules を理由に auto-start を飛ばす
target が曖昧なのに推測で範囲を広げる
Minimal Flow
mode を決める
上記の Review Target Detection で対象と base ref を決める
必要な reference だけ読む
差分、untracked files、関連テスト、仕様正本、Plans.md を確認する
APPROVE / REQUEST_CHANGES / decision_needed を返すREQUEST_CHANGES の場合は critical / major の修正方針と修正後再レビュー条件を示す
Review Governance Contract 詳細は references/governance.md。
ここでは最低限の合格ラインだけ固定する。
明確な合格ライン
critical / major が 0 件
仕様正本 (spec_path) または明示された spec_skip_reason と矛盾しない
Plans.md の task / DoD / Depends と矛盾しない既存テスト、既存 UX、既存 CLI、既存設定、既存 docs、配布 mirror のいずれにもデグレ証拠がない
検証証跡がある。APPROVE なのに evidence が空の出力は禁止
TeamAgent Debate を実行した場合、反対意見が解消済み、または minor / recommendation として理由付きで格下げ済み
TeamAgent Debate 詳細は references/team-debate.md。
TeamAgent Debate は、異なる見解を read-only で衝突させる review pass。
Agent 主な問い Spec Agent 仕様正本と実装差分の矛盾を探す Plans Agent Plans.md の task / DoD / Depends と差分の対応を確認するRegression Agent 既存挙動・テスト・配布 mirror・CLI/skill UX のデグレを探す Skeptic Agent 合格させたい前提で見落としている major risk を探す
Codex 環境で native TeamAgent が使えない場合でも、この gate を省略してはいけない。
codex-companion.sh review、利用可能な reviewer subagent、または明示的に分けた read-only manual-pass で同じ 2-4 視点を再現し、team_agent_mode に native / codex-companion / manual-pass / unavailable を記録する。
Code Review Summary 詳細は references/code-review.md。
通常 code review は次を見る。
Security
Performance
Quality
Accessibility
AI Residuals
Spec Alignment
Plans Alignment
Regression Safety
TDD compliance
仕様正本 alignment check は必須。
spec_path がある場合は差分が仕様正本と矛盾しないか確認し、仕様正本が必要なのに無い場合は spec_skip_reason の妥当性を見る。
Plans.md alignment check とデグレ alignment check も同じ gate で扱う。
AI Residuals は scripts/review-ai-residuals.sh と scripts/review-weak-supervision-report.sh を優先して使う。
untracked も見る場合は --include-untracked を使う。
mockData, dummy, fake, localhost, TODO, FIXME, it.skip, test.skip, expect(true).toBe(true) などは候補であり、diff 文脈で severity を決める。
finding 段階は網羅優先。minor と判定した指摘も observations[] / recommendations[] に残し、gate は verdict 段階だけで行う（Opus 4.8 は low-severity の報告を絞る癖がある。references/code-review.md の Finding coverage 参照）。
TDD compliance check TDD が required の task では skip_tdd_reason、red-log、focused tests の証跡を確認する。
証跡なしで APPROVE しない。
Quick / Codex Closeout Summary 詳細は references/codex-closeout.md。
target selection を先に固定する
Codex 指摘は advisory として扱い、実コードで確認してから採否を決める
final report には review command / tests / accepted findings / rejected findings / clean result を含める
stop-on-clean: clean result 後に、見栄えのためだけの追加 review をしない
Codex が使えない場合は full manual pass に fallback し、失敗を成功扱いしない
bash scripts/harness-review-closeout.sh --dry-run --uncommitted
bash scripts/harness-review-closeout.sh --base origin/main --parallel-tests --test "bash tests/test-harness-review-governance.sh"
bash scripts/harness-review-closeout.sh --commit HEAD
Plan Review Summary 詳細は references/plan-review.md。
Plan Review は Plans.md の DoD / Depends / Status と実装順序を見る。
仕様正本が必要なタスクで spec_path がない場合は、decision_needed として止める。
Scope Review Summary 詳細は references/scope-review.md。
Scope Review は、要求・差分・テスト・docs の境界が膨らんでいないかを見る。
範囲変更が必要なら、推測で進めず AskUserQuestion または plan 更新に戻す。
Security / UI / Dual
Security: references/security-profile.md
UI rubric: references/ui-rubric.md
high-res vision flow: references/vision-high-res-flow.md
Dual review: references/dual-review.md
/ultrareview は Harness flow 内では既定で呼ばない。
Harness flow の review-result.v1、commit guard、sprint-contract との接続を置き換えないため。
claude ultrareview [target] --json は CI / script からの second-opinion としてだけ扱う。
PR Host Boundary GitHub-first。
PR host 上の review 事実は GitHub を正とし、local diff は補助証拠として扱う。
ただし local uncommitted review は GitHub に push しない。
Output Contract User-facing prose follows the explicit session or project language.
If no language is configured, use English. Use Japanese only when
i18n.language: ja, CLAUDE_CODE_HARNESS_LANG=ja, or an explicit session
instruction requests Japanese output.
Machine-readable values stay English.
Start with the result summary.
## Review Result
### {APPROVE | REQUEST_CHANGES | decision_ needed} - {one-line conclusion}
Target: `{BASE_REF}..HEAD` or `{target}`
Verification: {commands run}
Strengths:
- ...
Findings:
- [severity] file:line - issue and evidence
Next Actions:
- ...
Details:
```json
{
"schema_version": "review-result.v1",
"verdict": "APPROVE | REQUEST_CHANGES",
"decision_needed": {
"required": false,
"ask_tool": "AskUserQuestion"
},
"accepted_findings": [],
"rejected_findings": [],
"acceptance_bar": {
"critical_major_zero": true,
"spec_alignment": "pass | fail | not_applicable",
"plans_alignment": "pass | fail | not_applicable",
"regression_safety": "pass | fail | not_applicable",
"verification_evidence": "pass | fail | not_applicable"
},
"team_debate": {
"required": false,
"mode": "native | codex-companion | manual-pass | unavailable",
"team_agent_mode": "native | codex-companion | manual-pass | unavailable",
"agents": [],
"disagreements": []
},
"critical_issues": [],
"major_issues": [],
"observations": [],
"recommendations": []
}
```
Persist Verdict (required for commit guard / #218 fix) Output Contract の JSON ブロックを出力したら、verdict が .claude/state/review-result.json に
必ず永続化される よう以下の step を最後に実行する。これを踏み忘れると、PreToolUse commit guard が
後続 git commit を APPROVE 無しでブロックする (harness-work step 10 と同じ pattern)。
mkdir -p .claude/state
cat > .claude/state/tmp-review-result.json <<'JSON'
{ "schema_version" : "review-result.v1" , "verdict" : "APPROVE" , ... }
JSON
bash "${HARNESS_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-$PWD } } /scripts/write-review-result.sh" \
.claude/state/tmp-review-result.json \
"$(git rev-parse --short HEAD 2>/dev/null || true) "
rm -f .claude/state/tmp-review-result.json
verdict が REQUEST_CHANGES でも保存する (commit guard は APPROVE のみ通過させ、REQUEST_CHANGES は履歴として残す)。
harness-release の Review Gate から委譲された場合も同じ step を踏む。
reviewer subagent は read-only (allowed-tools: Read, Grep, Glob) のため、上記 write 操作は orchestrator (skill を呼んだ main agent) が行う。
Codex Environment Codex 環境では使える tool が異なる。
それでも、合格ライン、仕様正本、Plans.md、デグレ、修正後再レビュー、AskUserQuestion / decision_needed.v1 の契約は同じ。
通常環境 Codex fallback Task tool の TeamAgent Debate reviewer subagent / codex-companion.sh review / manual-pass AskUserQuestion 使えない場合は decision_needed.v1 を stdout に出し、推測で進めない TaskList Plans.md を直接読む
Related Skills
harness-work: REQUEST_CHANGES 後の修正実行harness-plan: plan / scope / spec の更新harness-release: review 済み work の commit / release 