parent-project-skills について
workerd の範囲を超える作業で、親プロジェクトの情報を探して活用するためのスキルです。親プロジェクトの機密情報を公開用の workerd 成果物に含めないルールも定めています。
主な機能
- 01親プロジェクトのルート検出
- 02親プロジェクトのスキルと指針の検索
- 03関連するスキルファイルの直接読み込み
- 04一方向の情報境界の適用
活用シーン
- 01workerd に関わる本番環境の問題調査
- 02親プロジェクトでの統合テスト作成
- 03workerd の境界をまたぐデバッグ
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ cloudflare/ workerd --skill parent-project-skillsインストール後、Claude Code で/parent-project-skillsを入力して読み込まれたか確認します。
詳細
親プロジェクトのスキルの確認
このプロジェクト(workerd)は、より大きなプロジェクト内にサブモジュールとして組み込まれている場合があります。本番環境の問題の調査、統合テストの作成、デプロイアーキテクチャの把握など、workerd 自体を超えるコンテキストが必要な場合は、親プロジェクトに追加のスキルやコンテキストがないか確認してください。
確認手順
-
workerd ディレクトリより上に Git ルートがあるか確認し、親プロジェクトの有無を判断します。
- workerd ルートから見て
../../.gitまたは../../AGENTS.mdを確認します - 見つかった場合、親プロジェクトのルートは
../../(workerd から 2 階層上)です
- workerd ルートから見て
-
親プロジェクトのスキルを確認します。
../../.opencode/skills/*/SKILL.mdを確認します- プロジェクト全体のコンテキストについて、
../../AGENTS.mdまたは../../AGENTS.mdを読みます
-
SKILL.md ファイルを読み、関連するスキルを読み込みます。これらは
skillツールに登録されていないため、Read ツールで直接読み取ってください。 -
サブモジュール固有のコンテキストを確認します。
- workerd について言及している可能性がある
../../.opencode/skills/*/SKILL.mdファイルを確認します
- workerd について言及している可能性がある
情報の境界 — 重要
workerd はオープンソースプロジェクトです。親プロジェクトは通常、プロプライエタリまたは社内向けです。
厳格な一方向の情報境界を必ず守ってください。
- 許可:社内コンテキストを推論に役立て、コードパスの理解や調査の指針にすること
- 禁止:社内の詳細を workerd のファイルに記述すること。これには以下が含まれます。
- 社内システム、サービス、アーキテクチャに言及するコードコメント
- 社内プロジェクト、Sentry の問題、Jira チケット、社内 URL に言及するコミットメッセージ
- 社内コンテキストを含む PR の説明や GitHub の問題へのコメント
- 社内の知識を含む AGENTS.md、AGENTS.md、ドキュメントの更新
- 社内の詳細を明らかにする変数名、エラーメッセージ、ログ文字列
- 社内アーキテクチャ上の前提を埋め込んだテストファイル
境界をまたいで作業する場合、workerd 側の成果物は、親プロジェクトがどのように連携しているかには触れず、Workers、Durable Objects、isolate、IoContext など、workerd 独自の公開概念に基づいて記述してください。
このスキルを使用する場面
- workerd のコードに関係する本番環境の Sentry の問題を調査する場合
- 親プロジェクト内に置かれる統合テスト(例:ew-test)を作成する場合
- 本番環境へのデプロイ時に workerd API がどのように動作するかを把握する場合
- workerd と親プロジェクトの境界をまたぐ問題をデバッグする場合
- 両方のプロジェクトに影響するコード変更をレビューする場合
- workerd と親プロジェクトの連携が必要な新機能の開発を計画する場合
コメント
Markdown 対応