doc-check
コード変更に影響を受ける md ドキュメントを検出し、ユーザー承認後に更新する。 md ファイルの YAML frontmatter に宣言された depends-on（ファイルパス・glob）と 本文中の Markdown リンクから依存グラフを構築し、git diff との突合で影響範囲を特定する。 /doc-check で起動、またはコード変更を含むタスク完了時に実行を検討する。
Best use case
doc-check is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
コード変更に影響を受ける md ドキュメントを検出し、ユーザー承認後に更新する。 md ファイルの YAML frontmatter に宣言された depends-on（ファイルパス・glob）と 本文中の Markdown リンクから依存グラフを構築し、git diff との突合で影響範囲を特定する。 /doc-check で起動、またはコード変更を含むタスク完了時に実行を検討する。
Teams using doc-check should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/doc-check/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How doc-check Compares
| Feature / Agent | doc-check | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
コード変更に影響を受ける md ドキュメントを検出し、ユーザー承認後に更新する。 md ファイルの YAML frontmatter に宣言された depends-on（ファイルパス・glob）と 本文中の Markdown リンクから依存グラフを構築し、git diff との突合で影響範囲を特定する。 /doc-check で起動、またはコード変更を含むタスク完了時に実行を検討する。
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
コード変更に影響を受ける md ドキュメントを検出し、ユーザー承認後に更新する。 ## フロー 1. `scripts/doc-check.sh` を実行する 2. 出力を解釈し、影響ドキュメント一覧をユーザーに提示する 3. ドキュメントごとにユーザーの判断を確認する 4. 承認されたドキュメントを更新し、差分を提示する ## スクリプト実行 スキルディレクトリからの相対パスで実行する: ````bash # デフォルト: staged + unstaged の変更に対してチェック bash "$(dirname "$SKILL_PATH")/scripts/doc-check.sh" # コミット範囲を指定 bash "$(dirname "$SKILL_PATH")/scripts/doc-check.sh" --range HEAD~3..HEAD # ファイルを直接指定 bash "$(dirname "$SKILL_PATH")/scripts/doc-check.sh" --files src/api.ts src/handler.ts ```` ### 終了コード - `0`: 影響なし → 「影響を受けるドキュメントはありません」と報告して終了 - `1`: 影響あり → 次のステップへ - `2`: エラー → エラー内容を報告して終了 ## ユーザー確認 影響を受ける各ドキュメントについて、AskUserQuestion で以下を確認する: - **更新する** — ドキュメントと変更コードを読み込み、更新差分を提示する - **スキップ** — このドキュメントは更新不要と判断 - **後で対応** — 今回は更新せず、次回のチェックで再検出される ## 更新処理 「更新する」が選ばれた場合: 1. 対象ドキュメントを Read で読み込む 2. 変更されたコードファイルを Read で読み込む 3. コード変更の内容に基づきドキュメントを更新する 4. Edit で更新差分を適用する前に、変更内容をユーザーに提示する 5. ユーザー承認後に書き込む 連鎖影響（参照リンク経由）のドキュメントも同じ手順で処理する。 ## 制約 - `doc-check.sh` スクリプトの出力をそのまま解釈する。独自にファイル走査しない - ドキュメント更新前に必ずユーザー承認を得る。自動更新は禁止 - 設定されている言語で出力する
Related Skills
weekly-sync
Linear（SSOT）と顧客向け出力先（GitHub Project 等）の間で定例ミーティング向けの 週次同期を実行する。チケットのスキャン・差分分析・顧客向けDocument作成・出力先転写・ ステータス同期を一気通貫で行う。プロジェクト固有の設定は .weekly-sync/config.md で管理。
triage
URL（Slack/GitHub/その他）から情報収集→周辺コンテキスト探索→分析→Linear Issue 登録を行う初動対応ワークフロー。 問い合わせやバグ報告のトリアージに使用する。
slackcli
Slack CLI: Send messages, read conversations, search, and manage Slack workspaces from the terminal. Use when the user asks anything related to Slack — sending messages, checking unreads, searching conversations, or managing workspaces. Also trigger when a Slack URL is provided (e.g., https://*.slack.com/archives/*, app.slack.com/*) or when the conversation context mentions Slack threads, channels, or messages.
linear-refresh
Linear チケットの棚卸し・構造整理・未登録ソース発見を Collect/Discover/Analyze/Approve/Execute の 5 ステップで一気通貫実行する。 既存の外部リンク探索に加え、Slack/GitHub のキーワード検索と逆引きで未紐付きの 外部ソースも発見する。定期的な Linear メンテナンス、または「棚卸し」「リフレッシュ」 「整理」の依頼時に使用する。
handover
現在のセッションで行った作業・決定事項・アーキテクチャ変更を project-state.json に記録し、 handover.md を生成する。コンテキスト圧縮の直前、/handover の明示呼び出し、 ツール呼び出し累計 50 回超過時、または応答が遅延した時に使用する。
doc-audit
md ドキュメントの陳腐化・欠落・矛盾を 4 Layer 構造で検出し、ユーザー承認後に修正する。 depends-on 検証、coverage チェック、business-rule/architecture の未文書化知識検出、 readme/CLAUDE.md のメタ整合検査を行う。/doc-audit で起動、または大規模なコード変更後に ドキュメント整合性を確認したい時に使用する。
continue
前セッションの project-state.json から未完了タスク（in_progress/blocked）を特定し、 ユーザー承認後に作業を再開する。/continue の明示呼び出し、"continue from handover" のような継続指示、handover.md への言及を検出した時に使用する。worktree 切り替えと Pipeline Detection も含む。
ward-identity-checker
Ward Identity Checker
type-checker
Type Checker Skill
tizen-compliance-checker
Validates Tizen app compliance with TCT (Tizen Compliance Tests). Checks conformance to IoT, TV, or mobile profiles.
owasp-security-check
Security audit guidelines for web applications and REST APIs based on OWASP Top 10 and web security best practices. Use when checking code for vulnerabilities, reviewing auth/authz, auditing APIs, or before production deployment.
mcp-spec-checker
Predicate-level semantic diff for MCP protocol specs. Compares 0618 vs 1125 specs via Narya types, GF(3) evaluators, and Unison-style effects. Use for protocol verification, spec migration, or detecting breaking changes.