name: ai-pm-task-exec description: AI PMのタスクを取り出して実装・デプロイまで一貫実行する。URLまたはタスクIDを渡すとタスク内容を取得し、コード実装→ビルド→push→本番確認まで行う。 metadata: project: ai-pm-service repo: ksato8710/ai-pm-service url: https://ai-pm-service.craftgarden.studio triggers:

ai-pm-task-exec
AIタスク実行
PMタスク実行
タスクを実行

AI PM タスク実行スキル

AI PM Service のタスクを受け取り、実装からデプロイまで一貫して実行する。

呼び出し方

/ai-pm-task-exec <URL or タスクID>

例

# URL指定
/ai-pm-task-exec https://ai-pm-service.craftgarden.studio/tasks/1771825314010-dnptatu

# タスクID指定
/ai-pm-task-exec 1771825314010-dnptatu

引数の解釈

URL — https://ai-pm-service.craftgarden.studio/tasks/<id> 形式 → URLからタスクIDを抽出
タスクID — ID文字列のみ → そのまま使用
引数なし — 受信箱のタスク一覧を取得し、ユーザーに選択してもらう

⚠️ 重要: タスク取得方法

WebFetchではタスク内容を取得できない（SPAのため）。

推奨: スキル付属のスクリプトを使う

# タスク取得（ai-pm-serviceディレクトリで実行）
cd /Users/satokeita/Dev/ai-pm-service
node ~/.openclaw/skills/ai-pm-task-exec/scripts/get-task.mjs <task-id>

# タスク完了
node ~/.openclaw/skills/ai-pm-task-exec/scripts/complete-task.mjs <task-id>

実行フロー

Phase 0: コンテキスト読み込み（必須）

以下の2ファイルを 必ず Read ツールで読む:

/Users/satokeita/.openclaw/skills/ai-pm-service/LEARNINGS.md — 過去の学び・地雷
/Users/satokeita/.openclaw/skills/ai-pm-service/PROJECT-CONTEXT.md — DBスキーマ・技術スタック・ディレクトリ構成

Phase 1: タスク取得・分析

URLからタスクIDを抽出（/tasks/XXXXX → XXXXX）

スクリプトでタスク情報を取得:

cd /Users/satokeita/Dev/ai-pm-service
node ~/.openclaw/skills/ai-pm-task-exec/scripts/get-task.mjs <task-id>

タスクの要件を明確に整理し、ユーザーに実装方針を簡潔に報告
不明点があれば確認

Phase 2: 準備

cd /Users/satokeita/Dev/ai-pm-service
git pull origin main
git status

コンフリクトがあれば報告して停止
作業ブランチは使わず main で直接作業（個人プロジェクト）

Phase 3: 実装

対象リポジトリ: /Users/satokeita/Dev/ai-pm-service

コーディング規約:

UI文言: 日本語
変数名・関数名: 英語
ダークモードファースト
スマホファースト（タッチ操作しやすく）
Tailwind CSS v4 + shadcn/ui スタイル
Server Components + Client Components パターン
IME対応（isComposing チェック必須）

主要ファイル:

src/lib/db.ts — DBスキーマ・操作
src/types/index.ts — 型定義
src/lib/actions.ts — Server Actions
src/components/ui/ — 共通UIコンポーネント

Phase 4: ビルド確認

cd /Users/satokeita/Dev/ai-pm-service && pnpm build

TypeScriptエラー・ビルドエラーがあれば修正して再ビルド
ビルド成功するまで Phase 3 と Phase 4 を繰り返す

Phase 5: コミット & プッシュ

cd /Users/satokeita/Dev/ai-pm-service
git add <変更ファイル>
git commit -m "<コミットメッセージ（日本語）>"
git push origin main

コミットメッセージは日本語、conventional commits 形式（feat: / fix: / refactor:）
push は必ず実行する（LEARNINGS参照: push忘れが過去に発生）

Phase 6: 本番確認

Vercelデプロイ完了を待つ（push後60秒待機）
curl -s -o /dev/null -w "%{http_code}" https://ai-pm-service.craftgarden.studio/api/health で200確認
実装した機能に関連するページをWebFetchまたはagent-browserで確認

Phase 7: 学びを記録

/Users/satokeita/.openclaw/skills/ai-pm-service/LEARNINGS.md に以下を追記:

### [YYYY-MM-DD] タスク名
**やったこと**:
**ハマったこと**:
**学び/Tips**:
**変更したファイル**:

Phase 8: タスクをクローズ

タスクが完了したら、スクリプトでステータスを done に更新する:

cd /Users/satokeita/Dev/ai-pm-service
node ~/.openclaw/skills/ai-pm-task-exec/scripts/complete-task.mjs <task-id>

タスクIDの取得方法:

タスクURL https://ai-pm-service.craftgarden.studio/tasks/XXXXX の末尾がID
例: /tasks/1771872741238-mnfy9ix → ID: 1771872741238-mnfy9ix

完了チェックリスト

タスク内容を取得・理解
LEARNINGS.md / PROJECT-CONTEXT.md を読んだ
実装完了
pnpm build 成功
git push origin main 実行
Vercel デプロイ確認（200 OK）
LEARNINGS.md に学びを追記
MCP task_complete でタスクをクローズ
ユーザーに完了報告

参照

本番URL: https://ai-pm-service.craftgarden.studio （⚠️ vercel.appではなくこちらを使う！）
GitHub: https://github.com/ksato8710/ai-pm-service
ローカル: /Users/satokeita/Dev/ai-pm-service
コンテキスト: /Users/satokeita/.openclaw/skills/ai-pm-service/

⚠️ よくある落とし穴

WebFetchでタスク内容を取得しようとする: AI PM ServiceはSPAのためWebFetchではタスク内容が取れない。必ずスキル付属のget-task.mjsスクリプトを使うこと。スクリプトは/Users/satokeita/Dev/ai-pm-serviceディレクトリで実行する必要がある（node_modules依存）
git push忘れ: Claude Codeはcommitするがpushしない。Phase 5で必ずgit push origin mainを実行すること。LEARNINGS.mdにも過去の事故事例が記録されている
本番URLの間違い: 本番URLはhttps://ai-pm-service.craftgarden.studioであり、vercel.appではない。確認・報告時のURLを間違えないこと
LEARNINGS.md / PROJECT-CONTEXT.mdの読み飛ばし: Phase 0のコンテキスト読み込みを省略すると、過去にハマった同じ問題に再度ハマる。特にNext.js 16のキャッシュ更新API（updateTag）やDBスキーマの変更履歴は必読
スクリプトの依存解決失敗: get-task.mjsは@libsql/clientに依存するため、ai-pm-serviceディレクトリ以外で実行すると失敗する。失敗時はリポジトリ側の依存で同等クエリを実行する