System

カスタマイズ

実行する前に、次の場所にユーザーのカスタマイズがあるか確認してください： ~/.claude/skills/CORE/USER/SKILLCUSTOMIZATIONS/System/

このディレクトリが存在する場合は、そこにある PREFERENCES.md、設定、またはリソースを読み込んで適用してください。これらはデフォルトの動作より優先されます。ディレクトリが存在しない場合は、スキルのデフォルト設定を使用してください。

システムスキル

PAI システムのシステム検証、整合性監査、ドキュメントの追跡、セキュリティスキャンを行います。

表示

このスキルはフォアグラウンドで実行されるため、作業中のすべての出力や進捗を確認でき、音声通知も聞くことができます。透明性を保つため、ドキュメントの更新、整合性チェック、その他のシステム操作は表示されます。

---

音声通知

ワークフローを実行するときは、次の両方を行ってください：

1. 音声通知を送信する：

   curl -s -X POST http://localhost:8888/notify \
     -H "Content-Type: application/json" \
     -d '{"message": "Running WORKFLOWNAME workflow from System skill"}' \
     > /dev/null 2>&1 &
   

2. テキスト通知を出力する：

   Running the **WorkflowName** workflow from the **System** skill...
   

---

ワークフローの振り分け

コア操作（3つ）

ワークフロー	トリガー	目的	ファイル
IntegrityCheck	「integrity check」、「audit system」、「check references」、「system health」	システム全体の参照切れを見つけて修正します	Workflows/IntegrityCheck.md
DocumentSession	「document session」、「document today」、「document this session」、「log session」	トランスクリプトを基に、現在のセッションでの作業を記録します	Workflows/DocumentSession.md
DocumentRecent	「document recent」、「catch up docs」、「what's undocumented」、「document since last update」	最後に記録した更新以降の変更について、追いついてドキュメントを作成します	Workflows/DocumentRecent.md

組み合わせのルール：

• 整合性チェック → 修正が行われる場合があります → セッションの記録
• セッション終了後 → セッションの記録
• 定期的なキャッチアップ → 最近の変更の記録

セキュリティワークフロー

ワークフロー	トリガー	ファイル
SecretScanning	「check for secrets」、「scan for credentials」、「security scan」	Workflows/SecretScanning.md
PrivacyCheck	「privacy check」、「check for sensitive data」、「data isolation」	Workflows/PrivacyCheck.md

ユーティリティワークフロー

ワークフロー	トリガー	ファイル
WorkContextRecall	「we just worked on」、「what did we do with」、「remember when we」、「didn't we already」	Workflows/WorkContextRecall.md

注： 公開 PAI の整合性チェック（「check PAI integrity」、「audit PAI packs」）には、PAI スキルの PAIIntegrityCheck.md を使用してください。

---

使用例

コア操作

例 1：整合性チェック

User: "Run an integrity check"
→ Invokes IntegrityCheck workflow
→ Spawns parallel agents to audit ~/.claude
→ Finds broken references, missing files
→ Returns list of issues found/fixed

例 2：現在のセッションを記録

User: "Document this session"
→ Invokes DocumentSession workflow
→ Reads current session transcript
→ Uses AI to extract what changed and why
→ Creates entry in MEMORY/PAISYSTEMUPDATES/

例 3：キャッチアップのドキュメント作成

User: "What's undocumented? Catch up the docs."
→ Invokes DocumentRecent workflow
→ Finds last documented update timestamp
→ Compares git history since then
→ Generates documentation for missed changes

セキュリティワークフロー

例 4：シークレットスキャン

User: "Check for secrets before I push"
→ Invokes SecretScanning workflow
→ Runs TruffleHog on specified directory
→ Reports any API keys, credentials found

ユーティリティ

例 5：過去の作業を想起

User: "We just worked on the status line - why broken again?"
→ Invokes WorkContextRecall workflow
→ Searches MEMORY/, git history for "status line"
→ Presents timeline of changes and possible regression

---

クイックリファレンス

3つのコア操作

操作	入力	出力	所要時間
IntegrityCheck	コードベースのスキャン	見つかった／修正された参照切れの一覧	約2～5分
DocumentSession	セッションのトランスクリプト	PAISYSTEMUPDATES エントリー	約30秒
DocumentRecent	最後の更新以降の Git 履歴	複数の PAISYSTEMUPDATES エントリー	約1～2分

組み合わせパターン

End of Session:     DocumentSession
After Refactoring:  IntegrityCheck → DocumentSession
Catch-up:           DocumentRecent

セキュリティ監査

監査の種類	ツール	対象範囲	所要時間
シークレットスキャン	TruffleHog	任意のディレクトリ	約30秒～2分
プライバシーチェック	grep/patterns	skills/（USER/WORK を除く）	約30秒

ドキュメントの形式

詳細なナラティブ形式：

• ストーリー（1～3段落）：背景、問題、解決策
• 以前の動作：箇条書きで以前の状態を説明
• 現在の動作：改善点を含む新しい状態
• 今後の展望：今後への影響
• 検証：動作を確認する方法

---

使用するタイミング

整合性チェック

• 大規模なリファクタリングの後
• 更新をリリースする前
• 定期的なシステムの健全性チェック
• 何かがおかしいと感じたとき
• 公開 PAI リポジトリにプッシュする前

ドキュメント

• 重要な作業セッションの終了時
• 新しいスキル／ワークフロー／ツールの作成後
• アーキテクチャ上の決定を行ったとき
• システムの履歴を維持するため

セキュリティスキャン

• 公開リポジトリに Git コミットする前
• 認証情報の漏えいを監査するとき
• 定期的なセキュリティ衛生チェック
• 外部のコード／コンテンツを受け取った後

プライバシー検証

• USER/ または WORK/ のコンテンツを扱った後
• 公開コミットする前
• 個人データを参照する可能性のある新しいスキルを作成するとき
• データの分離を確実にするための定期監査

作業コンテキストの想起

• ユーザーが過去の作業について尋ねたとき（「今それを修正したばかりです」）
• 決定の理由についての質問
• 過去のセッションで作成された成果物の検索
• 「すでに修正済み」の問題のデバッグ
• 複数セッションにわたるプロジェクトの再開

---

ツール

ツール	用途	場所
SecretScan.ts	認証情報検出用の TruffleHog ラッパー	CORE/Tools/SecretScan.ts
CreateUpdate.ts	システム更新エントリーの新規作成	Tools/CreateUpdate.ts
UpdateIndex.ts	index.json と CHANGELOG.md の再生成	Tools/UpdateIndex.ts
UpdateSearch.ts	システム更新の検索と照会	Tools/UpdateSearch.ts
ExtractArchitectureUpdates.ts	過去の移行ツール（一度限りの使用）	Tools/ExtractArchitectureUpdates.ts

テンプレート

テンプレート	用途	場所
Update.md	システム更新エントリー用テンプレート	Templates/Update.md

---

出力先

出力	場所
整合性レポート	MEMORY/STATE/integrity/YYYY-MM-DD.md
システム更新	MEMORY/PAISYSTEMUPDATES/YYYY/MM/*.md
更新インデックス	MEMORY/PAISYSTEMUPDATES/index.json
変更履歴	MEMORY/PAISYSTEMUPDATES/CHANGELOG.md

---

関連スキル

• PAI - 公開 PAI リポジトリの管理（PAIIntegrityCheck を含む）
• CORE - システムアーキテクチャとメモリのドキュメント
• Evals - 回帰テストと機能検証