/video-ask
ユーザーを一画面で案内します:現在位置、各要素の状態、次に入力すべきコマンド。
1. ファイルから状態を読み取る(記憶からではない)
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/video-ask/scripts/status.py"
ユーザーが現在のフォルダ以外のフォルダについて質問した場合、最初の引数としてそのフォルダを渡します。
フィールド(パス、バージョン、ステージ)を正確に答える必要がある場合は、--json を追加します。
このスクリプトは、docs/contracts.md で定義されているファイルから各動画のステージを推測します。到達した最新のステージは次の通りです:
brief(概要)未署名、署名済み、ソース取得済み、truth(真実)、specs(仕様)、voice(音声)、built(ビルド済み)、rendered(レンダリング済み)、QA失敗、QA成功、delivered(納品済み)。
QAレポートは、その sha256 が最新のレンダリングと一致する場合にのみカウントされます。そのため、QA後に再レンダリングすると、再び rendered と表示されます。会話の前のターンで言われたことよりも、スクリプトの出力を信頼してください。サブエージェントがその間にファイルを変更している可能性があります。
2. 回答
スクリプトの出力をそのまま表示し(すでに短いです)、その後、次のコマンドを独立した行に表示します。 ユーザーが質問をした場合(引数がある場合)、ステータスの後に、以下のソースを順に使用して回答し、どのファイルを使用したかを明示します。
$PVS_HOME/README.md(スキルの概要、インストール方法、製品が必要とする入力内容)$PVS_HOME/docs/contracts.md(ファイル形式、フォルダ構成、コマンドライン)- 質問が該当するスキルの
SKILL.md($PVS_HOME/skills/内) - 製品の
kit/RULES.md(「なぜこのルールがあるのか」という質問に対する回答)
これらのファイルに回答がない場合は、推測せずにその旨を伝えます。
3. 見つけたときに指摘すべきこと
- セットアップ未完了: 次のコマンドは
/video-setupです。これより前に他の操作は確実に動作しません。 - ボイスキー未設定: ユーザーは自分のエディタでワークベンチの
.envに貼り付けます。決してチャット内では行いません。voice.provider: sayはキーなしでも動作します。.envを確認するために読み取らないでください。スクリプトがすでに設定済みかどうかを報告します。 - ワークベンチルートに製品がある場合: 各製品は独自のClaude Codeプロジェクトであり、独自のスキルとフックを持っています。ユーザーは
cd products/<slug> && claudeを実行して作業します。 - 概要未署名: ビルドはレビューアによる2つの署名を意図的に待ちます。これらのスキルの元となった本番環境では、26バージョンのうち9つが、動画で説明すべき機能について誰も合意していなかったために発生しました。レビューアの署名フィールドを編集することを提案しないでください。
- QA失敗: 該当動画の
qa/REPORT.mdを指摘し、失敗したチェックを確認するよう促します。
このスキルから構築、修正、納品を開始しないでください。このスキルは報告のみを行います。ユーザーが次のコマンドを入力します。