メニュー
ユーザーと対話しながら機能仕様を策定し、Notion に自動でドキュメント化するスキル。「仕様を作ろう」「スペックを書いて」「仕様を詰めよう」などの指示で呼び出される。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
GitHub に関する全ての操作やこのプロジェクトの GitHub に関する情報が欲しい時に呼び出されるスキル（PR, Issue）
git に関する全ての操作やこのプロジェクトのgitに関する情報が欲しい時に呼び出されるスキル（branch, commit, push, pull, merge ...）
Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.
app 側のページ実装を `@playlistwizard/ui` へページ単位で移行するための方針。`@/components/ui/*` import の置換、共通コンポーネント化、既存表示差分の抑制、packages/ui 側の variant 設計を伴う作業で参照すること。
Next.js AppRouter における、データフェッチング、データベースへのクエリ発行のベストプラクティス。データフェッチを伴う処理を実装、変更する場合はこのドキュメントを参照すること。
Notion の仕様ページをレビューし、セキュリティ・考慮漏れ・既存実装との整合性などの問題点をコメントとして報告するスキル。「仕様をレビューして」「スペックをチェックして」「review-spec」などの指示で呼び出される。
| name | create-spec |
| description | ユーザーと対話しながら機能仕様を策定し、Notion に自動でドキュメント化するスキル。「仕様を作ろう」「スペックを書いて」「仕様を詰めよう」などの指示で呼び出される。 |
| allowed-tools | ["Read","Glob","Grep","AskUserQuestion","mcp__notion__notion-create-pages","mcp__notion__notion-fetch","ListMcpResourcesTool","ReadMcpResourceTool"] |
引数として渡された機能名・概要をもとに、ユーザーへのインタビューを通じて仕様を深堀りし、最終的に Notion にドキュメントとして保存する。
ARGUMENTS) から機能名と概要を取得する
AskUserQuestion ツールを使ってインタビューを繰り返す。必ず AskUserQuestion ツールを使うこと。会話文での質問は禁止。
## Decisions
| 項目 | 選択 | 理由 | 備考 |
|------|------|------|------|
| ... | ... | ... | ... |
その後、未決事項・曖昧な点があれば次のラウンドへ進む。
インタビュー結果をまとめる前に、以下の観点で必ず検証する。ユーザーが指示した内容であっても疑いを持ち、問題があれば AskUserQuestion で確認を取ること。
問題が見つかればユーザーに提示し、仕様を修正してから次フェーズへ進む。
ReadMcpResourceTool("notion://docs/enhanced-markdown-spec")
| 設定 | 値 |
|---|---|
| データソース ID | 2fd066ac-825e-8057-b618-000b4c1f69a4 |
| カテゴリ | PlaylistWizard |
| アイコン | /icons/document_purple.svg |
以下のセクションを使用する。内容が不要なセクションは省略する。 mermaid 図・テーブル・コードブロックを積極的に活用して PlaylistActionJobQueue と同等の品質にすること。
# 概要
{機能の一文説明}
**背景と目的**
- 現状: {現在の課題・状況}
- 目的: {この機能で達成したいこと}
**技術スタック** (必要な場合)
| レイヤー | 技術 | 役割 |
|----------|------|------|
| ... | ... | ... |
---
# アーキテクチャ (必要な場合)
## 構成図
{mermaid flowchart など}
## シーケンス図 (必要な場合)
{mermaid sequenceDiagram}
---
# セキュリティ・認可 (必要な場合)
{認証・認可フロー。外部入力の検証ポイントも含む}
---
# 仕様
{機能の詳細仕様。型定義・バリデーションルールなど}
---
# API 仕様 (必要な場合)
{エンドポイント定義・リクエスト/レスポンス・エラーコード}
---
# DB スキーマ (必要な場合)
{Drizzle スキーマ定義}
---
# ファイル構成 (必要な場合)
{追加・変更するファイル一覧}
mcp__notion__notion-create-pages({
parent: { type: "data_source_id", data_source_id: "2fd066ac-825e-8057-b618-000b4c1f69a4" },
pages: [{
properties: {
"名前": "<機能名>",
"カテゴリ": "PlaylistWizard"
},
icon: "/icons/document_purple.svg",
content: "<Notion Markdown 形式の仕様>"
}]
})
作成完了後、Notion ページの URL をユーザーに表示して完了を伝える。