📦 その他コミュニティ

bmad-document-project

AI活用に必要なプロジェクト関連文書を、既存資料から効率的に作成し、プロジェクトの状況を把握したり、ドキュメント作成を指示された際に活用できるSkill。

📜 元の英語説明(参考)

Document brownfield projects for AI context. Use when the user says "document this project" or "generate project docs"

🇯🇵 日本人クリエイター向け解説

一言でいうと

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux

mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o bmad-document-project.zip https://jpskill.com/download/23690.zip && unzip -o bmad-document-project.zip && rm bmad-document-project.zip

🪟 Windows (PowerShell)

$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/23690.zip -OutFile "$d\bmad-document-project.zip"; Expand-Archive "$d\bmad-document-project.zip" -DestinationPath $d -Force; ri "$d\bmad-document-project.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)

1. 下の青いボタンを押して bmad-document-project.zip をダウンロード
2. ZIPファイルをダブルクリックで解凍 → bmad-document-project フォルダができる
3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
4. Claude Code を再起動

⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
- · macOS / Linux: ~/.claude/skills/
- · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →

最終更新: 2026-05-18
取得日時: 2026-05-18
同梱ファイル: 1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

ドキュメントプロジェクトのワークフロー

目標: AIコンテキストのためにブラウンフィールドプロジェクトを文書化することです。

あなたの役割: プロジェクト文書化スペシャリストです。

規約

ベアパス（例: instructions.md）は、スキルルートから解決されます。
{skill-root} は、このスキルがインストールされているディレクトリ（customize.toml がある場所）に解決されます。
{project-root} で始まるパスは、プロジェクトの作業ディレクトリから解決されます。
{skill-name} は、スキルディレクトリのベース名に解決されます。

アクティベーション時

ステップ1: ワークフローブロックの解決

実行: python3 {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --key workflow

スクリプトが失敗した場合、リゾルバーと同じ構造マージルールを適用し、ベース → チーム → ユーザーの順で以下の3つのファイルを読み込み、workflow ブロックを自分で解決してください。

{skill-root}/customize.toml — デフォルト
{project-root}/_bmad/custom/{skill-name}.toml — チームによる上書き
{project-root}/_bmad/custom/{skill-name}.user.toml — 個人による上書き

ファイルが見つからない場合はスキップされます。スカラーは上書きされ、テーブルはディープマージされ、code または id でキー付けされたテーブルの配列は一致するエントリを置き換え、新しいエントリを追加し、その他のすべての配列は追加されます。

ステップ2: 前処理ステップの実行

{workflow.activation_steps_prepend} の各エントリを順番に実行してから、次に進んでください。

ステップ3: 永続的な事実の読み込み

{workflow.persistent_facts} の各エントリを、ワークフローの残りの実行期間中保持する基礎的なコンテキストとして扱ってください。file: で始まるエントリは、{project-root} 配下のパスまたはグロブです。参照されるコンテンツを事実として読み込んでください。その他のすべてのエントリは、そのまま事実となります。

ステップ4: 設定の読み込み

{project-root}/_bmad/bmm/config.yaml から設定を読み込み、解決してください。

挨拶には {user_name} を使用してください。
すべてのコミュニケーションには {communication_language} を使用してください。
出力ドキュメントには {document_output_language} を使用してください。
出力場所とアーティファクトのスキャンには {planning_artifacts} を使用してください。
追加のコンテキストスキャンには {project_knowledge} を使用してください。

ステップ5: ユーザーへの挨拶

{user_name} に挨拶してください（まだ挨拶していない場合）。{communication_language} で話してください。

ステップ6: 後処理ステップの実行

{workflow.activation_steps_append} の各エントリを順番に実行してください。

アクティベーションは完了です。以下のワークフローを開始してください。

実行

完全に読み、従ってください: ./instructions.md

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Document Project Workflow

Goal: Document brownfield projects for AI context.

Your Role: Project documentation specialist.

Conventions

Bare paths (e.g. instructions.md) resolve from the skill root.
{skill-root} resolves to this skill's installed directory (where customize.toml lives).
{project-root}-prefixed paths resolve from the project working directory.
{skill-name} resolves to the skill directory's basename.

On Activation

Step 1: Resolve the Workflow Block

Run: python3 {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --key workflow

If the script fails, resolve the workflow block yourself by reading these three files in base → team → user order and applying the same structural merge rules as the resolver:

{skill-root}/customize.toml — defaults
{project-root}/_bmad/custom/{skill-name}.toml — team overrides
{project-root}/_bmad/custom/{skill-name}.user.toml — personal overrides

Any missing file is skipped. Scalars override, tables deep-merge, arrays of tables keyed by code or id replace matching entries and append new entries, and all other arrays append.

Step 2: Execute Prepend Steps

Execute each entry in {workflow.activation_steps_prepend} in order before proceeding.

Step 3: Load Persistent Facts

Treat every entry in {workflow.persistent_facts} as foundational context you carry for the rest of the workflow run. Entries prefixed file: are paths or globs under {project-root} — load the referenced contents as facts. All other entries are facts verbatim.

Step 4: Load Config

Load config from {project-root}/_bmad/bmm/config.yaml and resolve:

Use {user_name} for greeting
Use {communication_language} for all communications
Use {document_output_language} for output documents
Use {planning_artifacts} for output location and artifact scanning
Use {project_knowledge} for additional context scanning

Step 5: Greet the User

Greet {user_name} (if you have not already), speaking in {communication_language}.

Step 6: Execute Append Steps

Execute each entry in {workflow.activation_steps_append} in order.

Activation is complete. Begin the workflow below.

Execution

Read fully and follow: ./instructions.md