Verify document self-containedness by having a context-free sub-agent explain its understanding. Use after writing specs, handoff docs, or any document that must be understood without conversation context.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
설치 방법 보기설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.
文脈なしのサブエージェントにドキュメントを読ませ、理解を説明させることで、ドキュメントが自己完結的かを検証する。
「すべてを忘れて明日読んでも思い出せるか」をテストする。
会話の中で暗黙に共有された文脈に依存していないか、第三者が初見で理解できるかを確認する。
/verify-doc path/to/file.md): 指定ファイルを検証/verify-doc): 直近で作成・編集したドキュメントを推定して検証引数でファイルパスが指定されていればそれを使う。 指定がなければ、会話コンテキストから直近に Write/Edit したドキュメントファイル（.md）を特定する。
Task ツールで haiku モデルの general-purpose サブエージェントを起動する。
重要: サブエージェントには会話コンテキストを一切渡さない。ファイルパスと評価指示のみ。
Task({
subagent_type: "general-purpose",
model: "haiku",
description: "Verify doc comprehensibility",
prompt: `
以下のファイルを読んで、あなたの理解を説明してください。
このファイルだけを読んで、文脈なしで理解できるかの検証です。
ファイル: <検証対象ファイルパス>
以下の観点で説明してください:
1. **何を解決するものか**（1-2文）
2. **成果物は何か**（箇条書き）
3. **主要な設計判断とその理由**（箇条書き）
4. **全体フローを自分の言葉で説明**（箇条書き）
5. **読んで不明だった点・曖昧に感じた点**（あれば具体的に。なければ「なし」）
日本語で回答してください。簡潔に。
`
})
サブエージェントの回答を以下の基準で評価する:
| 判定 | 基準 |
|---|---|
| ✅ 自己完結 | 観点1-4が正確に理解され、不明点が「なし」 |
| ⚠️ 概ね理解可能 | 大筋は正しいが、一部不明点や誤解がある |
| ❌ 文脈依存 | 重要な要素を誤解、または不明点が多い |
報告フォーマット:
## 文書検証結果: <ファイル名>
**判定**: ✅ / ⚠️ / ❌
### サブエージェントの理解
[サブエージェントの回答を要約]
### 検出された問題（⚠️/❌ の場合）
- [誤解された箇所とその原因]
- [不明と報告された箇所]
### 改善提案（⚠️/❌ の場合）
- [具体的な追記・修正の提案]
⚠️ または ❌ の場合、文書のどこをどう改善すれば自己完結性が高まるかを具体的に提案する。 ユーザーが同意すれば、その場で Edit ツールで修正する。
| 場面 | 重要度 |
|---|---|
| 仕様書（spec）の作成後 | 高 — 次セッションで実装する前提 |
/task-handoff 前のタスク記述 | 高 — 別セッションで実行する前提 |
| ADR（設計決定記録）の作成後 | 中 — 長期保存される文書 |
/session-memo で保存したメモ | 低 — 軽量メモなので必須ではない |
아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.
로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.
Migrate existing ADRs to YAML frontmatter format. Scans docs/decisions/ for ADRs without frontmatter, infers status from body text, shows dry-run for approval. Trigger: /adr-migrate
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
Start or resume an ADR session. Without number: show status overview and recommend next actionable ADR. With number: provide phase-specific guidance. Trigger: /adr-session, /adr-session NNN, /adr-session new
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
Analyze a project's harness maturity and guide staged adoption of Harness Engineering best practices (quality loops, safety gates, linters, CLAUDE.md optimization).
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
Standardized bug fix workflow using TDD (Red-Green-Refactor). Use when fixing bugs, resolving issues, or when the user invokes /bugfix. Ensures root cause analysis, failing test first, then minimal fix.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
Create detailed specifications by iteratively clarifying unclear points for Plan mode. Use when: After completing a plan when detailed requirements need clarification before implementation.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
Policy-enforcing installer that deploys hardened Claude Code Action workflows (`@claude` manual mention + dependency-bot auto-fix) into a personal GitHub repository the user administers. Use when asked to introduce Claude Code Action, apply `@claude` mention support, or set up automated CI auto-fix for dependency bot PRs, using the security-hardened templates shipped with this skill.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.