// 機能実装後のドキュメント（スキル、CLAUDE.md）更新を支援するガイド。 変更検出、スキル更新のタイミング・手順、コード例の書き方を提供。 「ドキュメント更新」「スキル更新」「CLAUDE.md修正」などのリクエスト時にトリガー。
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | tumiki-docs-update-guide |
| description | 機能実装後のドキュメント（スキル、CLAUDE.md）更新を支援するガイド。 変更検出、スキル更新のタイミング・手順、コード例の書き方を提供。 「ドキュメント更新」「スキル更新」「CLAUDE.md修正」などのリクエスト時にトリガー。 |
| sourcePatterns | [".claude/skills/**","CLAUDE.md"] |
各スキルには sourcePatterns が定義されており、対応するソースファイルが変更された場合にスキルの更新が必要になります。
| スキル名 | 対応パターン |
|---|---|
| tumiki-custom-mcp-server-feature | packages/db/prisma/schema/userMcpServer.prisma, apps/manager/src/server/api/routers/v2/userMcpServer/**, apps/manager/src/atoms/integratedFlowAtoms.ts, apps/manager/src/app/**/mcps/create-integrated/** |
| tumiki-dynamic-search-feature | apps/mcp-proxy/src/features/dynamicSearch/**, apps/mcp-proxy/src/features/mcp/mcpRequestHandler.ts, apps/mcp-proxy/src/features/mcp/commands/callTool/** |
| tumiki-ee-ce-separation | apps/manager/src/**/*.ee.ts, apps/manager/src/features/ee/**, apps/manager/next.config.js, apps/manager/tsconfig.ce.json |
| tumiki-mcp-proxy-architecture | apps/mcp-proxy/src/domain/**, apps/mcp-proxy/src/features/**, apps/mcp-proxy/src/infrastructure/**, apps/mcp-proxy/src/shared/** |
| tumiki-prisma-schema-changes | packages/db/prisma/schema/*.prisma |
# 最新5コミットの変更ファイル
git diff --name-only HEAD~5
# mainブランチからの変更
git diff --name-only main
# 特定のコミットからの変更
git diff --name-only <commit-hash>
変更されたファイルと上記の sourcePatterns を照合し、更新が必要なスキルを特定。
スキル内のコード例と実際のソースコードを比較し、乖離がないか確認。
# 例: スキーマ定義の確認
grep -A 10 "CreateIntegratedMcpServerInputV2" apps/manager/src/server/api/routers/v2/userMcpServer/index.ts
.claude/skills/<skill-name>/SKILL.md
sourcePatterns が正しく設定されているか確認。
---
description: スキルの説明
sourcePatterns:
- packages/db/prisma/schema/*.prisma
- apps/manager/src/**/*.ts
---
実際のソースコードからコード例をコピーし、スキルに反映。
コード例の書き方ガイドライン：
// apps/manager/src/server/api/routers/v2/userMcpServer/index.ts
const CreateIntegratedMcpServerInputV2 = z.object({
name: nameValidationSchema,
description: z.string().optional(),
templates: z
.array(/* ... */)
.min(2, "統合サーバーには2つ以上のテンプレートが必要です"),
});
新しい確認事項があれば追加。
発見した問題と解決方法を追記。
| セクション | 更新タイミング |
|---|---|
| 主要な開発コマンド | 新しいnpm scriptの追加時 |
| 開発ガイドライン | コーディング規約の追加・変更時 |
| 重要なアーキテクチャパターン | 新しいアーキテクチャパターンの導入時 |
| トラブルシューティング | 新しい問題と解決方法の発見時 |
| 機能セクション（統合MCP、Dynamic Search等） | 該当機能の変更時 |
---
name: skill-name
description: |
スキルの説明（1-2文）。トリガー条件を含める。
「キーワード1」「キーワード2」などのリクエスト時にトリガー。
sourcePatterns:
- 対応するソースファイルパターン
---
# スキル名
## アーキテクチャ概要
（全体像の説明）
## コンポーネント構成
（ファイル構成）
## 型定義
（主要な型）
## 実装詳細
（コード例付きの詳細説明）
## 実装チェックリスト
（確認事項）
## トラブルシューティング
（よくある問題と解決方法）
重要:
name フィールドは必須description に含める（bodyに「このスキルを使用する場面」セクションは不要）sourcePatterns:
# 単一ファイル
- packages/db/prisma/schema/userMcpServer.prisma
# ディレクトリ内の全ファイル
- apps/mcp-proxy/src/features/dynamicSearch/**
# 特定の拡張子
- packages/db/prisma/schema/*.prisma
# 複数階層のワイルドカード
- apps/manager/src/app/**/mcps/create-integrated/**
機能実装が完了したら、以下を確認：
sourcePatterns に該当するか確認スキル内のコード例と実際の実装が乖離し、参照時に混乱を招きます。
定期的に /tumiki-docs-update-guide スキルを参照して確認してください。
外部から見える変更（型定義、API、ファイル構成）は必ず更新。 内部ロジックのみの変更は任意です。