🛠️ 開発・MCP コミュニティ

devdocs-onboard

AIツールを切り替えたり、新しいメンバーがプロジェクトに加わったりする際に、「プロジェクトの状況」「引き継ぎ」「オンボーディング」といったキーワードに反応し、AIツールがスムーズに移行できるようプロジェクトの概要をまとめるSkill。

📜 元の英語説明(参考)

Generate project context summary for AI tool handover. Use when switching AI tools, starting new sessions, or onboarding team members. Triggers on keywords like "project context", "handover", "onboard", "项目上下文", "交接", "接手项目".

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

一言でいうと

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

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

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

🍎 Mac / 🐧 Linux

mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o devdocs-onboard.zip https://jpskill.com/download/8773.zip && unzip -o devdocs-onboard.zip && rm devdocs-onboard.zip

🪟 Windows (PowerShell)

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

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

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

1. 下の青いボタンを押して devdocs-onboard.zip をダウンロード
2. ZIPファイルをダブルクリックで解凍 → devdocs-onboard フォルダができる
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ツールやチームメンバーがプロジェクトを迅速に理解し、作業を引き継ぐのを支援します。

実行モード

/devdocs-onboard              → スマート検出（読み取りまたは書き込みを質問）
/devdocs-onboard --read       → 既存のドキュメントのみを読み取り、変更は行わない
/devdocs-onboard --update     → 強制的に再スキャンして更新

モード	ドキュメントの読み取り	プロジェクトのスキャン	ファイルへの書き込み	適用シーン
スマート検出	✅	場合による	場合による	不確かな場合
`--read`	✅	❌	❌	新しい AI がプロジェクトを引き継ぐ場合
`--update`	-	✅	✅	段階的な作業完了後

スマート検出フロー

00-context.md が存在するかどうかを検出
        │
        ├── 存在しない → 自動的に更新モードに入る
        │
        └── 存在する → ユーザーに質問
                    ├── "既存の内容を読み取る" → ドキュメントを表示し、変更は行わない
                    └── "再スキャンして更新" → プロジェクトをスキャンし、ファイルを上書き

言語ルール

日本語と英語での質問をサポート
日本語での統一された回答
日本語を使用してドキュメントを生成

トリガー条件

ユーザーが AI ツールを切り替え、コンテキストを渡す必要がある場合
ユーザーが新しい会話セッションを開始する場合
チームメンバーがプロジェクトを理解する必要がある場合
ユーザーがプロジェクトの概要を生成するように要求する場合

核心理念

コンテキスト伝達の問題

セッション A (Claude Code)          セッション B (新しい AI ツール)
        │                            │
        ├── プロジェクト構造を理解              │ ← 再度理解する必要がある
        ├── 設計ドキュメントを読み取る              │ ← 再度読み取る必要がある
        ├── 現在の進捗状況を理解              │ ← 再度理解する必要がある
        └── 次のタスクを知っている            │ ← 再度確認する必要がある
                                     │
                    ┌────────────────┘
                    ▼
             /devdocs-onboard
                    │
                    ▼
            コンテキスト概要を生成
                    │
                    ▼
             迅速なプロジェクト引き継ぎ

核心原則：

1つのドキュメントにすべての重要なコンテキストが含まれていること
新しい AI が読み取った後、すぐに作業を開始できること
重複する探索や質問を避けること

ワークフロー

1. DevDocs ドキュメントをスキャン
   │
   ▼
2. 重要な情報を抽出
   ├── プロジェクト概要
   ├── 技術アーキテクチャ
   ├── 現在の進捗状況
   └── ToDo
   │
   ▼
3. コードリポジトリ構造をスキャン
   │
   ▼
4. コンテキスト概要を生成
   │
   ▼
5. ファイルを出力（新しい AI に直接渡すことができる）

出力ファイル

メインファイル：docs/devdocs/00-context.md

このファイルは、新しい AI ツールに初期コンテキストとして直接コピーできるように設計されています。

ドキュメント構造

# プロジェクトコンテキスト：<プロジェクト名>

**生成時間**：YYYY-MM-DD HH:mm
**生成ツール**：/devdocs-onboard

---

## 1. プロジェクト概要

### 1.1 プロジェクト目標
<01-requirements.md から抽出>

### 1.2 主要機能
| 编号 | 機能 | 状態 |
|------|------|------|
| F-001 | <機能名> | ✅ 完了 / 🔄 進行中 / ⏳ 開発待ち |

### 1.3 技術スタック
<02-system-design.md から抽出>

---

## 2. システムアーキテクチャ

### 2.1 アーキテクチャ概要
<02-system-design.md からアーキテクチャ図を抽出>

### 2.2 主要モジュール
| モジュール | 役割 | キーファイル |
|------|------|----------|
| <モジュール名> | <役割> | `src/xxx/` |

### 2.3 主要インターフェース
<02-system-design.md からキーインターフェースのシグネチャを抽出>

---

## 3. コード構造

### 3.1 ディレクトリ構造

<実際のプロジェクトディレクトリ構造、ls/tree で取得>


### 3.2 主要ファイルの説明
| ファイル | 用途 |
|------|------|
| `src/index.ts` | エントリーファイル |
| `src/config.ts` | 構成管理 |

---

## 4. 現在の進捗状況

### 4.1 全体的な進捗状況
| タイプ | 合計 | 完了 | 進行中 | 完了率 |
|------|------|--------|--------|--------|
| 機能ポイント | X | X | X | XX% |
| 開発タスク | X | X | X | XX% |

### 4.2 最近完了
- T-05: <タスク名> (YYYY-MM-DD)
- T-04: <タスク名> (YYYY-MM-DD)

### 4.3 現在進行中
- T-06: <タスク名>
  - 状態：<進捗状況の説明>
  - 関連ファイル：`src/xxx.ts`

### 4.4 未コミットの変更
<未コミットのコード変更がある場合は、リスト表示>

---

## 5. ToDo

### 5.1 次のタスク
| 優先度 | タスク | 依存関係 | 関連要件 |
|--------|------|------|----------|
| P0 | T-07: <タスク名> | T-06 | F-002, AC-005 |

### 5.2 阻害要因
<阻害要因がある場合は、リスト表示>

---

## 6. 重要な約束

### 6.1 コーディング規約
- MTE 原則（保守性、テスト可能性、拡張性）に従う
- 関数は 50 行を超えない
- パラメータは 5 つを超えない

### 6.2 テスト要件
- 単体テストカバレッジ ≥ 80%
- 弱いアサーションの禁止

### 6.3 コミット規約
<git log からプロジェクトのコミットスタイルを抽出>

---

## 7. クイックスタート

### 7.1 環境準備
```bash
<依存関係のインストールコマンド>

7.2 プロジェクトの実行

<実行コマンド>

7.3 テストの実行

<テストコマンド>

8. DevDocs ドキュメントインデックス

ドキュメント	パス	説明
要件ドキュメント	`docs/devdocs/01-requirements.md`	機能ポイント、ユーザーストーリー、受け入れ基準
システム設計	`docs/devdocs/02-system-design.md`	アーキテクチャ、インターフェース、データモデル
テストケース	`docs/devdocs/03-test-cases.md`	テスト戦略、トレーサビリティマトリックス
開発タスク	`docs/devdocs/04-dev-tasks.md`	タスクリスト、依存関係

引き継ぎの提案：

まず、このドキュメントを読んで全体像を把握する
「現在進行中」のタスクステータスを確認する
「次のタスク」から開発を続ける
詳細な問題が発生した場合は、対応する DevDocs ドキュメントを参照する

情報抽出ルール

DevDocs から抽出

情報	ソースドキュメント	抽出内容
プロジェクト目標	`01-requirements.md`	要件の背景、ターゲットユーザー
機能リスト	`01-requirements.md`	F-XXX 機能ポイントとステータス
技術スタック	`02-system-design.md`	技術選定表
アーキテクチャ図	`02-system-design.md`	アーキテクチャ概要図
主要インターフェース	`02-system-design.md`	インターフェースシグネチャテーブル
現在の進捗状況	`04-dev-tasks.md`	実行チェックリスト
ToDo	`04-dev-tasks.md`	未完了の T-XX

コードリポジトリから抽出

情報	抽出方法
ディレクトリ構造	`ls -la` または `tree`
主要ファイル	package.json、エントリファイルを分析
未コミットの変更	`git status`
コミットスタイル	`git log --oneline -5`
実行コマンド	package.json scripts または Makefile から抽出

使用シーン

シーン1：作業を完了し、引き継ぎの準備をする（--update）

ユーザー: /devdocs-onboard --update

Agent: プロジェクトをスキャンしてコンテキストを生成しています...
✅ docs/devdocs/00-context.md を更新しました

このファイルの内容を新しい AI ツールにコピーすると、プロジェクトをすばやく理解して作業を引き継ぐことができます。

シーン2：新しい AI がプロジェクトを引き継ぐ（--read）

ユーザー: /devdocs-onboard --read

Agent: プロジェクトコンテキストを読み込んでいます...

[00-context.md の内容を表示]

現在の進捗状況：8/12 タスクが完了 (67%)
次：T-09 ユーザー認証モジュール

「ToDo」セクションから開発を続けることをお勧めします。

シーン3：不明な場合（スマート検出）

ユーザー: /devdocs-onboard

Agent: docs/devdocs/00-context.md が既に存在すること（2時間前に更新）を検出しました

選択してください：
1. 既存の内容を読み取る（変更しない）
2. 再スキャンして更新する

ユーザー: 1

Agent: [既存のドキュメントの内容を表示]

制約

生成制約

[ ] すべての DevDocs ドキュメントをスキャンする必要がある
[ ] 現在のコードリポジトリの状態を確認する必要がある
[ ] 未コミットの変更情報を含める必要がある
[ ] 出力ファイルは自己完結型である必要がある（外部リンクに依存して理解しない）
[ ] 重要な情報は直接表示する必要がある（ドキュメントパスを引用するだけではない）

内容制約

[ ] プロジェクトの概要は 200 字以内
[ ] アーキテクチャ図を含める必要がある（ASCII または Mermaid）
[ ] 次に実行可能なタスクをリストする必要がある
[ ] 機密情報（キー、パスワード）を含めてはならない
[ ] ファイルパスは正確でアクセス可能である必要がある

更新制約

[ ] 生成するたびに古いファイルを上書きする
[ ] 生成時間を記録する必要がある
[ ] DevDocs が存在しない場合は、関連する skill を最初に実行するようにユーザーに促す

Skill 連携

シーン	連携 Skill	説明
DevDocs が存在しない	`/devdocs-retrofit`	まずコードからリバースエンジニアリングしてドキュメントを生成する
進捗情報が古い	`/devdocs-sync`	まずドキュメントの状態を同期する
詳細なタスクが必要	`/devdocs-dev-tasks`	完全なタスクリストを表示する

コマンドオプション

# スマート検出：ドキュメントの存在状態に基づいてユーザーに質問する
/devdocs-onboard

# 読み取り専用モード：既存のドキュメントを読み取って表示し、変更は行わない
/devdocs-onboard --read

# 更新モード：強制的にプロジェクトを再スキャンしてドキュメントを更新する
/devdocs-onboard --update

次のステップ

引き継ぎ側（ツール A）

段階的な作業が完了したら、/devdocs-onboard --update を実行する
00-context.md の内容を新しい AI ツールに渡す

引き受け側（ツール B）

/devdocs-onboard --read を実行してプロジェクトを理解する
「ToDo」セクションから開発を続ける
作業が完了したら、/devdocs-onboard --update を実行してコンテキストを更新する

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

项目上下文

生成项目上下文摘要，帮助 AI 工具或团队成员快速了解项目并接手工作。

运行模式

/devdocs-onboard              → 智能检测（询问读或写）
/devdocs-onboard --read       → 只读取现有文档，不修改
/devdocs-onboard --update     → 强制重新扫描更新

模式	读取文档	扫描项目	写入文件	适用场景
智能检测	✅	视情况	视情况	不确定时
`--read`	✅	❌	❌	新 AI 接手项目
`--update`	-	✅	✅	完成阶段性工作后

智能检测流程

检测 00-context.md 是否存在
        │
        ├── 不存在 → 自动进入更新模式
        │
        └── 存在 → 询问用户
                    ├── "读取现有内容" → 展示文档，不修改
                    └── "重新扫描更新" → 扫描项目，覆盖文件

语言规则

支持中英文提问
统一中文回复
使用中文生成文档

触发条件

用户切换 AI 工具，需要传递上下文
用户开始新的对话会话
团队成员需要了解项目
用户要求生成项目简报

核心理念

上下文传递问题

会话 A (Claude Code)          会话 B (新 AI 工具)
        │                            │
        ├── 了解项目结构              │ ← 需要重新了解
        ├── 读取设计文档              │ ← 需要重新读取
        ├── 理解当前进度              │ ← 需要重新理解
        └── 知道下一步任务            │ ← 需要重新确认
                                     │
                    ┌────────────────┘
                    ▼
             /devdocs-onboard
                    │
                    ▼
            生成上下文摘要
                    │
                    ▼
             快速接手项目

核心原则：

一份文档包含所有关键上下文
新 AI 读取后能立即开始工作
避免重复探索和询问

工作流程

1. 扫描 DevDocs 文档
   │
   ▼
2. 提取关键信息
   ├── 项目概述
   ├── 技术架构
   ├── 当前进度
   └── 待办任务
   │
   ▼
3. 扫描代码库结构
   │
   ▼
4. 生成上下文摘要
   │
   ▼
5. 输出文件（可直接传递给新 AI）

输出文件

主文件：docs/devdocs/00-context.md

此文件设计为可直接复制给新 AI 工具作为初始上下文。

文档结构

# 项目上下文：<项目名称>

**生成时间**：YYYY-MM-DD HH:mm
**生成工具**：/devdocs-onboard

---

## 1. 项目概述

### 1.1 项目目标
<从 01-requirements.md 提取>

### 1.2 核心功能
| 编号 | 功能 | 状态 |
|------|------|------|
| F-001 | <功能名称> | ✅ 已完成 / 🔄 进行中 / ⏳ 待开发 |

### 1.3 技术栈
<从 02-system-design.md 提取>

---

## 2. 系统架构

### 2.1 架构概览
<从 02-system-design.md 提取架构图>

### 2.2 核心模块
| 模块 | 职责 | 关键文件 |
|------|------|----------|
| <模块名> | <职责> | `src/xxx/` |

### 2.3 核心接口
<从 02-system-design.md 提取关键接口签名>

---

## 3. 代码结构

### 3.1 目录结构

<实际项目目录结构，通过 ls/tree 获取>


### 3.2 关键文件说明
| 文件 | 用途 |
|------|------|
| `src/index.ts` | 入口文件 |
| `src/config.ts` | 配置管理 |

---

## 4. 当前进度

### 4.1 总体进度
| 类型 | 总数 | 已完成 | 进行中 | 完成率 |
|------|------|--------|--------|--------|
| 功能点 | X | X | X | XX% |
| 开发任务 | X | X | X | XX% |

### 4.2 最近完成
- T-05: <任务名称> (YYYY-MM-DD)
- T-04: <任务名称> (YYYY-MM-DD)

### 4.3 当前进行中
- T-06: <任务名称>
  - 状态：<进度描述>
  - 涉及文件：`src/xxx.ts`

### 4.4 未提交变更
<如有未提交的代码变更，列出>

---

## 5. 待办任务

### 5.1 下一步任务
| 优先级 | 任务 | 依赖 | 关联需求 |
|--------|------|------|----------|
| P0 | T-07: <任务名称> | T-06 | F-002, AC-005 |

### 5.2 阻塞项
<如有阻塞项，列出>

---

## 6. 重要约定

### 6.1 编码规范
- 遵循 MTE 原则（可维护、可测试、可扩展）
- 函数不超过 50 行
- 参数不超过 5 个

### 6.2 测试要求
- 单元测试覆盖率 ≥ 80%
- 禁止弱断言

### 6.3 提交规范
<从 git log 提取项目提交风格>

---

## 7. 快速开始

### 7.1 环境准备
```bash
<安装依赖命令>

7.2 运行项目

<运行命令>

7.3 运行测试

<测试命令>

8. DevDocs 文档索引

文档	路径	说明
需求文档	`docs/devdocs/01-requirements.md`	功能点、用户故事、验收标准
系统设计	`docs/devdocs/02-system-design.md`	架构、接口、数据模型
测试用例	`docs/devdocs/03-test-cases.md`	测试策略、追溯矩阵
开发任务	`docs/devdocs/04-dev-tasks.md`	任务列表、依赖关系

接手建议：

先阅读本文档了解全貌
查看"当前进行中"任务状态
从"下一步任务"继续开发
遇到细节问题查阅对应 DevDocs 文档

信息提取规则

从 DevDocs 提取

信息	来源文档	提取内容
项目目标	`01-requirements.md`	需求背景、目标用户
功能列表	`01-requirements.md`	F-XXX 功能点及状态
技术栈	`02-system-design.md`	技术选型表
架构图	`02-system-design.md`	架构概览图
核心接口	`02-system-design.md`	接口签名表
当前进度	`04-dev-tasks.md`	执行检查清单
待办任务	`04-dev-tasks.md`	未完成的 T-XX

从代码库提取

信息	提取方法
目录结构	`ls -la` 或 `tree`
关键文件	分析 package.json、入口文件
未提交变更	`git status`
提交风格	`git log --oneline -5`
运行命令	从 package.json scripts 或 Makefile 提取

使用场景

场景一：完成工作，准备交接（--update）

用户: /devdocs-onboard --update

Agent: 正在扫描项目并生成上下文...
✅ 已更新 docs/devdocs/00-context.md

您可以将此文件内容复制给新的 AI 工具，它将快速了解项目并接手工作。

场景二：新 AI 接手项目（--read）

用户: /devdocs-onboard --read

Agent: 正在读取项目上下文...

[展示 00-context.md 内容]

当前进度：8/12 任务已完成 (67%)
下一步：T-09 用户认证模块

建议从"待办任务"部分继续开发。

场景三：不确定时（智能检测）

用户: /devdocs-onboard

Agent: 检测到 docs/devdocs/00-context.md 已存在（更新于 2 小时前）

请选择：
1. 读取现有内容（不修改）
2. 重新扫描更新

用户: 1

Agent: [展示现有文档内容]

约束

生成约束

[ ] 必须扫描所有 DevDocs 文档
[ ] 必须检查当前代码库状态
[ ] 必须包含未提交变更信息
[ ] 输出文件必须自包含（不依赖外部链接理解）
[ ] 关键信息必须直接展示（不只是引用文档路径）

内容约束

[ ] 项目概述不超过 200 字
[ ] 架构图必须包含（ASCII 或 Mermaid）
[ ] 必须列出下一步可执行的任务
[ ] 敏感信息（密钥、密码）不得包含
[ ] 文件路径必须准确可访问

更新约束

[ ] 每次生成覆盖旧文件
[ ] 生成时间必须记录
[ ] 如 DevDocs 不存在，提示用户先运行相关 skill

Skill 协作

场景	协作 Skill	说明
DevDocs 不存在	`/devdocs-retrofit`	先从代码逆向生成文档
进度信息过时	`/devdocs-sync`	先同步文档状态
需要详细任务	`/devdocs-dev-tasks`	查看完整任务列表

命令选项

# 智能检测：根据文档存在状态询问用户
/devdocs-onboard

# 只读模式：读取并展示现有文档，不做任何修改
/devdocs-onboard --read

# 更新模式：强制重新扫描项目并更新文档
/devdocs-onboard --update

devdocs-onboard

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

🎯 このSkillでできること

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

📖 Skill本文(日本語訳)

プロジェクトコンテキスト

実行モード

スマート検出フロー

言語ルール

トリガー条件

核心理念

コンテキスト伝達の問題

ワークフロー

出力ファイル

ドキュメント構造

7.2 プロジェクトの実行

7.3 テストの実行

8. DevDocs ドキュメントインデックス

情報抽出ルール

DevDocs から抽出

コードリポジトリから抽出

使用シーン

シーン1：作業を完了し、引き継ぎの準備をする（--update）

シーン2：新しい AI がプロジェクトを引き継ぐ（--read）

シーン3：不明な場合（スマート検出）

制約

生成制約

内容制約

更新制約

Skill 連携

コマンドオプション

次のステップ

引き継ぎ側（ツール A）

引き受け側（ツール B）

项目上下文

运行模式

智能检测流程

语言规则

触发条件

核心理念

上下文传递问题

工作流程

输出文件

文档结构

7.2 运行项目

7.3 运行测试

8. DevDocs 文档索引

信息提取规则

从 DevDocs 提取

从代码库提取

使用场景

场景一：完成工作，准备交接（--update）

场景二：新 AI 接手项目（--read）

场景三：不确定时（智能检测）

约束

生成约束

内容约束

更新约束

Skill 协作

命令选项

下一步

交接方（工具 A）

接手方（工具 B）