開発効率化 on hdknr blog

Claude Code の /team-onboarding コマンドで新メンバーへの使い方説明が1コマンドで完結する

Thu, 16 Apr 2026 00:00:00 +0000

Claude Code に /team-onboarding というコマンドが追加された。新メンバーが入るたびに口頭で説明していた「うちのチームの Claude Code の使い方」が、1コマンドで自動ドキュメント化されるようになった。

新メンバーへの説明を毎回繰り返す課題

チームで Claude Code を使っていると、新メンバーが入るたびに「うちってどうやって Claude Code 使ってるの？」という質問が飛んでくる。毎回同じことを口頭で説明するのは時間がかかるし、言語化が難しい暗黙知も多い。

/team-onboarding が解決すること

/team-onboarding コマンドを実行すると、Claude Code が実行したユーザーの過去のセッション履歴を分析して、チーム向けのオンボーディング資料を自動生成してくれる。

生成される内容は以下のとおり：

過去30日のセッションを自動分析
作業タイプの割合をテキスト形式で可視化（例：Build 40%, Plan 25% など ※実行例）
よく使うスキルを頻度順にランキング
MCP 接続の使用回数を可視化
新メンバー向けセットアップチェックリストを生成

出力は Markdown 形式なので、Notion や GitHub Wiki にそのままコピペできる。ドキュメント整備の手間が省ける。

使い方

プロジェクトルートで Claude Code を起動し、チャット欄に入力するだけ：

1

/team-onboarding

実行すると、セッション履歴が分析され、チームへの共有に適したオンボーディングドキュメントが生成される。

まとめ

「新メンバーのオンボーディングに毎回時間を取られる」という壁を崩すコマンドだ。チームの暗黙知を自動でドキュメント化し、Notion や GitHub にそのまま貼れる Markdown で出力される。Claude Code をチームで使っている場合は試してみる価値がある。

元ツイート（@SuguruKun_ai）より

Claude Code にカオスエンジニアリングエージェントを導入してリポジトリの弱点を発見する

Tue, 07 Apr 2026 00:00:00 +0000

Claude Code のカスタムエージェント機能を使って「カオスエンジニア」を導入すると、リポジトリの潜在的な弱点を自動的に発見できる。.md ファイルを1つ置くだけで有効化でき、驚くほど多くの問題が見つかることで話題になっている。

カオスエンジニアリングとは

カオスエンジニアリングは、本番システムに意図的に障害を注入してシステムの耐障害性を検証する手法だ。Netflix が提唱した概念で、Chaos Monkey のような自動障害注入ツールが知られている。

Claude Code にカオスエンジニアリングの思考を持ったエージェントを持ち込むと、コードベースに対して「もし〇〇が壊れたら？」という視点で弱点分析を行ってくれる。

導入方法

Claude Code のカスタムエージェントは .claude/agents/ ディレクトリに .md ファイルを置くだけで使える。

以下が chaos-engineer エージェントの定義例だ:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24


# chaos-engineer

あなたはカオスエンジニアリングの専門家です。
システムに意図的に障害を起こす視点でリポジトリを分析し、
潜在的な弱点・単一障害点・エラーハンドリングの欠如を特定してください。

## 分析観点

- 単一障害点（SPOF）の特定
- エラーハンドリングの欠如箇所
- タイムアウト設定の不備
- リトライ処理の欠如
- 環境変数・設定値のハードコーディング
- 依存サービスがダウンした場合の挙動
- データ整合性が保証されない処理
- テストカバレッジが低い重要処理

## 出力形式

各問題について以下を明記する:
- 問題箇所（ファイルパス・行番号）
- 障害シナリオ
- 影響範囲
- 推奨する対策

このファイルを .claude/agents/chaos-engineer.md として保存する。

Claude Code スキル活用の知見：Anthropic 社内での実践から学んだこと

Tue, 17 Mar 2026 00:00:00 +0000

Anthropic で Claude Code を開発している Thariq が、社内での大規模なスキル活用から得た知見をまとめたノートが公開された。スキルは Claude Code の最も使われる拡張ポイントの一つであり、柔軟で作りやすく配布もしやすい。しかしその柔軟性ゆえに「何が正解か」を判断しにくいという問題もある。本記事はそのノートの内容を日本語でまとめたものだ。

スキルとは何か

スキルは「ただの Markdown ファイル」という誤解が多いが、実際にはスクリプト・アセット・データなどを含むフォルダー全体がスキルだ。Claude Code では動的なフックの登録など多彩な設定オプションも提供されている。

最も面白いスキルは、こうした設定オプションやフォルダー構造をクリエイティブに活用しているものだ。

スキルの 9 つのカテゴリ

社内のスキルを棚卸ししたところ、いくつかのカテゴリに分類できた。最も優れたスキルは一つのカテゴリに綺麗に収まる。自組織でどのカテゴリが欠けているかを確認するのに役立つ。

1. ライブラリ・API リファレンス

ライブラリ、CLI、SDK の正しい使い方を説明するスキル。内部ライブラリや Claude Code が苦手とする一般的なライブラリを対象にする。参照コードスニペットのフォルダーや、Claude が避けるべき「落とし穴（gotchas）」リストを含めることが多い。

例:

billing-lib — 社内課金ライブラリのエッジケースや注意点
internal-platform-cli — 社内 CLI の全サブコマンドと使用例
frontend-design — 自社デザインシステムに Claude を合わせる

2. プロダクト検証

コードが正しく動作しているかをテスト・検証するスキル。Playwright や tmux などの外部ツールと組み合わせることが多い。検証スキルは Claude のアウトプットの正確性を担保するために極めて有用で、エンジニアが 1 週間かけて磨き上げる価値がある。

出力の動画録画や各ステップでのプログラムによるアサーションなどの手法も有効だ。

例:

signup-flow-driver — サインアップ → メール確認 → オンボーディングをヘッドレスブラウザで実行
checkout-verifier — Stripe テストカードでチェックアウト UI を操作し、請求書の状態を確認
tmux-cli-driver — TTY が必要なインタラクティブ CLI テスト用

3. データ取得・分析

データ・監視スタックに接続するスキル。認証情報付きでデータを取得するライブラリ、特定のダッシュボード ID、一般的なワークフローの手順などを含む。