Skip to main content Início Criadores whyzsm tiny-agents harness-plan-brief
harness-plan-brief Plan Brief HTML for pre-implementation preview (searches harness-mem for past decisions/patterns). Triggers: plan brief, planning preview, 計画概要, 計画レビュー. Skip for: implementation, review, 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-plan-briefO 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
3 arquivos name harness-plan-brief description Plan Brief HTML for pre-implementation preview (searches harness-mem for past decisions/patterns). Triggers: plan brief, planning preview, 計画概要, 計画レビュー. Skip for: implementation, review, release. description-en Plan Brief HTML for pre-implementation preview (searches harness-mem for past decisions/patterns). Triggers: plan brief, planning preview, 計画概要, 計画レビュー. Skip for: implementation, review, release. description-ja 実装着手前に Plan Brief HTML を生成する。現プロジェクトのみで harness-mem を検索し (`strict_project: true`)、過去 decision / pattern / Plans archive から類似案件を抽出して `plan-brief-context.v1` schema に整形、`render-html.sh` で単独 HTML を生成しブラウザ自動 open する。Use when: 計画概要, 非エンジニア向け事前共有, 提案前 review。Do NOT load for: 実装作業, code review, release。 allowed-tools ["Read","Write","Edit","Bash"] argument-hint [task-description] user-invocable true
harness-plan-brief
非エンジニアの発注者・プロデューサー職向けに、Claude が着手しようとしている計画を HTML 1 枚 で提示するスキル。
発注者の認知負荷ピーク (1) 計画理解の段階で使う。
Quick Reference
「Plan Brief を作って 」 → このスキル
「実装前にざっくり整理 」 → このスキル
「非エンジニア向けに計画を見せて 」 → このスキル
責任境界
範囲 このスキルの責務 検索 現プロジェクトのみ (project: <current>, strict_project: true を必ず指定)クロスプロジェクト やらない (Phase 65.3 以降で --cross-project-group <name> flag で opt-in 解放)書き込み やらない (Plan Brief 承認後の memory write は plan-brief-record-decision.sh の責務) confidence 算出 65.1.3 で実装される scripts/plan-brief-compile.sh に委譲
入力
引数 [task-description] にユーザーの request を渡す。
引数なしの場合は対話形式で受け取る。
出力
出力 パス 形式 Plan Brief HTML .claude/state/views/plan-brief-<timestamp>.html単独で開ける HTML (no server, no JS framework) Plan Brief context JSON .claude/state/views/plan-brief-<timestamp>.context.jsonplan-brief-context.v1 schema
Schema: plan-brief-context.v1
{
"schema" : "plan-brief-context.v1" ,
"user_request" : "string (ユーザーの request 原文)" ,
"my_understanding" : "string (Claude の理解を 1-3 段落で)" ,
"options" : [
{
"name"
:
"string"
,
"summary"
:
"string"
,
"pros"
:
[
"string"
]
,
"cons"
:
[
"string"
]
}
]
,
"risks"
:
[
{
"kind"
:
"string"
,
"severity"
:
"info|warn|critical"
,
"description"
:
"string"
,
"mitigation"
:
"string"
}
]
,
"acceptance_criteria"
:
[
{
"id"
:
"string"
,
"description"
:
"string"
,
"verifiable_by"
:
"string"
}
]
,
"tdd_required"
:
"yes|no|skip:<reason>"
,
"confidence"
:
0
,
"confidence_evidence"
:
[
"string"
]
,
"related_decisions"
:
[
{
"id"
:
"string"
,
"title"
:
"string"
,
"relevance"
:
"string"
}
]
,
"similar_past_plans"
:
[
{
"archive_path"
:
"string"
,
"phase"
:
"string"
,
"outcome"
:
"cc:完了|cc:WIP|cc:TODO|skipped"
,
"relevance"
:
"string"
}
]
,
"project"
:
"string"
,
"generated_at"
:
"ISO8601"
}
Execution Flow スキル起動時、Claude は以下の手順で動作する。
Step 1: project name を解決 PROJECT_NAME="$(basename "$(git rev-parse --show-toplevel) " ) "
PROJECT_NAME が空 (git 外) の場合は current をデフォルトに使う。
Step 2: harness-mem を project-only で検索する (default) 引数に --cross-project-group <name> flag がない 場合 (default behavior):
mcp__harness__harness_mem_search を 必ず 以下のパラメータで呼び出す:
project: <PROJECT_NAME>
strict_project: true
query: <user request>
expand_links: true
limit: 5
重要 : project パラメータは必須 。空文字列や null を渡してはならない。
strict_project: true を指定し、cross-project な検索は絶対に行わない 。
必要なら tags filter で decision / pattern を絞ってもよいが、project は固定。
過去 decision (D1-D41) / pattern (P1-P33) / Plans archive 28 件から類似案件を最大 5 件取得する。
Step 2 (alt): cross-project search (Phase 65.3.5 opt-in) 引数に --cross-project-group <name> flag がある 場合のみ:
D43 Option α (MCP N-call) に従い、以下の手順で cross-project 検索を行う。
MEMBERS_JSON="$(bash scripts/load-cross-project-groups.sh --group "<name>" 2>/dev/null) " || {
echo "ERROR: cross-project group not found: <name>" >&2
exit 1
}
MEMBERS_JSON が [] (空配列) の場合は warning を出して default の単一 project search に fallback。
MEMBERS_JSON が非空の場合、各 member project に対して MCP search を 1 回ずつ発行 する:
for each project in MEMBERS_JSON:
mcp__harness__harness_mem_search(
project: <member>,
strict_project: true,
query: <user request>,
expand_links: true,
limit: 5
)
各 search 結果を client 側でマージ・dedupe (id 単位)・relevance_score 降順 sort し、最大 5 件に絞る。
合計呼び出し数が多くなる (group が 5 project なら 5 回) ため、レイテンシは増える点に注意。
D43 判断 1 の根拠 : MCP tool schema には projects: [array] も strict_project: false も
exposed されていないため、横断検索は client 側 N-call が唯一の選択肢。
詳細は .claude/rules/cross-repo-handoff.md の「Phase 65.3 実装決定事項 (D43)」参照。
cross-project 結果には Layer 2/3 (Phase 65.3.2-65.3.4) の redaction を必ず通すこと:
HTML レンダリング時に bash scripts/render-html.sh ... --with-redaction を使用
これにより辞書 + NER + final scan の 3 段で固有名詞が漏れない
Step 3: context JSON を組み立てる scripts/plan-brief-compile.sh (Phase 65.1.3 で実装) を使って、
mem search 結果から plan-brief-context.v1 schema 準拠の JSON を構築する。
65.1.3 が未実装の段階では、Claude が直接 jq で以下を組み立てる:
jq -n \
--arg req "$USER_REQUEST " \
--arg proj "$PROJECT_NAME " \
--arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ) " \
'{
schema: "plan-brief-context.v1",
user_request: $req,
my_understanding: "(まだ未着手)",
options: [],
risks: [],
acceptance_criteria: [],
confidence: 0,
confidence_evidence: ["(stub) 65.1.3 で算出ロジック実装"],
tdd_required: "no",
related_decisions: [],
similar_past_plans: [],
project: $proj,
generated_at: $ts
}' > "$CONTEXT_JSON "
Step 4: HTML を生成する scripts/render-html.sh (Phase 65.1.1) を templates/html/plan-brief.html.template で呼ぶ:
HTML には TDD 判定を 1 行で表示する。
形式は tdd_required: yes、tdd_required: no、または tdd_required: skip:<reason> のいずれかにする。
bash scripts/render-html.sh \
--template plan-brief \
--data "$CONTEXT_JSON " \
--out "$HTML_OUT "
Step 5: ブラウザで自動 open する scripts/plan-brief-open.sh で OS 別 dispatch:
bash scripts/plan-brief-open.sh "$HTML_OUT "
BROWSER=true の env が設定されている場合 (CI 環境)、open は skip され printf で path だけ出力する。
Step 6: ユーザー承認待ち 「この理解で実装に進んでよいか」を確認する。
承認後の memory write は別スキル (Phase 65.1.4 の plan-brief-record-decision.sh) の責務。
失敗時の挙動 失敗 挙動 mcp__harness__harness_mem_search 不達警告を表示し、related_decisions / similar_past_plans を空配列で続行 git rev-parse --show-toplevel 失敗PROJECT_NAME=current で続行render-html.sh 失敗エラーを stderr に出力し exit 1 plan-brief-open.sh 失敗HTML path を stdout に出力するだけで exit 0 (browser open は best-effort)
Related
scripts/render-html.sh (Phase 65.1.1) — HTML テンプレートエンジンscripts/plan-brief-compile.sh (Phase 65.1.3) — context compilationscripts/plan-brief-record-decision.sh (Phase 65.1.4) — 承認 memory writeharness-accept skill (Phase 65.2.1) — 受け入れ判断スキル (対構造)harness-progress skill (Phase 65.4.1) — 進行管理スキル (対構造) 