ワンクリックで
setup-references
プロジェクトの外部参照先(Issue tracker, Figma, ドキュメント等)を対話でヒアリングし、docs/references.md に一元管理する。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
メニュー
プロジェクトの外部参照先(Issue tracker, Figma, ドキュメント等)を対話でヒアリングし、docs/references.md に一元管理する。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
実装完了後のコードレビューに使用。仕様準拠・コード品質・セキュリティの3観点を並列レビューし、指摘を依存解決して修正する。
セッション完了後の振り返りに使用。ワークフロー遵守の検証、ユーザ指摘の収集と自己改善提案、改善後のリグレッション確認を行う。
ワークフローを開始する。ユースケースを選択し、適切なステップを順に実行する
設計確定後、実装前に使用。設計をタスクに分解し、実装順序と依存関係を明確にする。
大規模プロジェクト(複数機能・フェーズ分割が必要)で使用。全体をフェーズに分割し、マイルストーンとリスクを定義する。各フェーズは planning スキルに渡す。
機能開発・バグ修正の着手前に使用。メインセッションで人間パートナーと対話し、要件を構造化する。コード調査は Explore エージェントに委譲。
| name | setup-references |
| description | プロジェクトの外部参照先(Issue tracker, Figma, ドキュメント等)を対話でヒアリングし、docs/references.md に一元管理する。 |
プロジェクトが依存する外部参照先を対話でヒアリングし、docs/references.md に一元管理する。
スキルやエージェントはこのファイルを参照して正しいURLを取得する。
入力: なし(対話で進める)
出力: docs/references.md
原則: 参照先が散在していたら、誰も正しいリンクを見つけられない。
docs/references.md が存在するか確認する。
以下のカテゴリについて、順番にヒアリングする。 全カテゴリを聞く必要はない。 該当しないものは「なし」でスキップ。
| カテゴリ | 聞くこと |
|---|---|
| Issue Tracker | ツール名(Jira / Linear / GitHub Issues 等)、URL、プロジェクトキー |
| Design | Figma URL、ページ単位の区分があれば |
| Documentation | 仕様書、ADR、Wiki 等の置き場所 |
| Repository | メインリポジトリ以外の関連リポジトリ |
| Environments | staging / production 等の URL |
| CI/CD | パイプラインの URL |
| Monitoring | ダッシュボード、ログ、アラートの URL |
| Communication | Slack チャンネル、Teams 等 |
| API Docs | Swagger / OpenAPI 等の URL |
ヒアリングの進め方:
ヒアリング結果を docs/references.md に出力する。
# Project References
> このファイルはプロジェクトの外部参照先を一元管理する SSOT です。
> スキル・エージェントはここを参照して正しい URL を取得します。
## Issue Tracker
- **ツール**: Jira
- **プロジェクト**: [PROJ](https://your-org.atlassian.net/browse/PROJ)
## Design
- [メイン Figma ファイル](https://www.figma.com/file/xxx)
## Documentation
- [仕様書](https://...)
- [ADR](https://...)
## Environments
| 環境 | URL |
|------|-----|
| Staging | https://staging.example.com |
| Production | https://example.com |
## CI/CD
- [GitHub Actions](https://github.com/org/repo/actions)
## Monitoring
- [Datadog Dashboard](https://...)
## Communication
- Slack: `#project-name`
## API Docs
- [OpenAPI Spec](https://...)
該当しないカテゴリのセクションは出力しない。
既存の docs/references.md がある場合:
このスキルは委譲しない。 メインセッションが直接対話する。 対話が目的なので、サブエージェントに任せると体験が損なわれる。
前提スキル:
このファイルを参照するスキル:
このファイルを参照するエージェント: