/product-new
ワークベンチに1つの製品フォルダを作成します。短いインタビュー、フォルダを作成する1つのスクリプト、その後、2つのモデル呼び出しスキル(source-recon がコードをフェッチ、product-kit がトークン、フォント、アイコン、ロゴ、キャスト、名前を抽出)を実行します。
なぜ何よりも先にインタビューを行うのか:これらのスキルが由来する本番環境では、キャスト、製品名、ポジショニングは一度に一つずつレビューで決まり、そのたびに再レンダリングが発生していました。ここで収集されたすべての回答は、後で発生しなかったレビューラウンド1回分です。
開始前
このスキルの実際のパスからワークベンチを解決します(ワークベンチおよび製品フォルダから動作します):
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
引数からスラッグを確認します。2~40文字の小文字、数字、またはダッシュで、文字で始まっていること。$PVS_HOME/products/<slug> がすでに存在する場合は停止してその旨を伝えます。製品を上書きしないでください。製品には独自の履歴と、おそらく署名済みの概要が含まれています。ユーザーが --from examples/acme(または別のフォルダ)を渡した場合、インタビューではそれと異なる点のみが必要です。
リポジトリに接続する前に、一度だけユーザーに伝えます:Claudeは製品のコードを読み取ります。つまり、コードはモデルにコンテキストとして送信されます。ユーザーは自分の会社がそれを許可していることを確認する必要があります。
1. インタビュー
ユーザーの言語で、メッセージごとに2~3問の小グループで質問します。推測できるものにはデフォルト値を提案し、ユーザーが主に確認するだけにします。完全な質問リストとその理由は references/interview.md にあります。質問する前に読んでください。
- 製品:その名前、一言で何か(ポジショニング)、誰のためのものか。
- 禁止フレーズ:チームが拒否する説明文(会社の文書で使用されていても)。
- ソース:それぞれ(フロントエンド、バックエンド、デザイン、ドキュメント)について、git URLまたはローカルパス、本番環境にあるブランチ、アプリディレクトリ、フレームワーク(
angular-primeng、react、vue、svelte、html、other)。実際にデプロイされているブランチを尋ねてください。古いチェックアウトは、元の本番環境で実際に時間を無駄にしました。 - ドキュメント:URL、リポジトリパス、または
mcp:<name>(読み取り専用)。 - ブランド:フロントエンドにない場合のみ(ロゴとフォントファイル)。それ以外は
product-kitが見つけます。 - 架空のキャスト:会社と、フルネーム、555電話番号、
example/.testドメインのメールアドレスを持つ2~3人を提案します。提案をデフォルトとして、クローズド質問で拒否権を提供します。レビュアーは、平凡または現実的な名前、およびビデオ間で姓が変わる人物に強く反応します。これは出荷されるバグです。 - 名前と発音:正式な名前、ライブUIにまだ表示される可能性のあるレガシー文字列、ブランド用語の発音方法。
- 禁止用語:競合他社、ベンダー、実際の顧客、決して見たり聞いたりしてはいけないもの。
- レビュアー:各ビデオのカバレッジマトリックスとクレームシートに署名する人。
トークン、パスワード、SSHキーを決して要求せず、保存も提供しないでください。ソースは、マシンがすでに持っているgitアクセスでフェッチされます。URLに資格情報が含まれている場合(https://user:token@...)、ユーザーに削除するよう依頼してください。スクリプトはそれらを拒否します。
2. フォルダを作成する
回答を product.yaml のような形のスクラッチファイルに書き込みます(任意のサブセット。references/answers.example.json を参照)。リポジトリの外部に保存した後、以下を実行します:
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/product-new/scripts/new_product.py" <slug> \
--answers <scratch>/answers.json [--from examples/acme]
スクリプトは _template/product をコピーし、その上に --from フォルダをコピーします(そのため、kit/RULES.md のようなファイルがない例でもテンプレートのものが取得されます)。回答を product.yaml に行ごとにマージし(テンプレートのコメントはユーザーのドキュメントであるため保持されます)、テンプレートにない場合は CLAUDE.md と .gitignore を作成し、scripts/link-skills.sh を実行して cd products/<slug> && claude が同じスキルを認識するようにし、最初のgitコミットを作成します。既存のスラッグ、URL内の資格情報、明らかに架空でないキャストのメールや電話番号を拒否します。失敗した場合は、問題のある回答を修正して再実行してください。手動でフォルダを作成しないでください。
「product.yaml にまだ記入すべき項目があります」と出力された場合、それらはインタビューでカバーされなかったテンプレートのプレースホルダーです。それらについて質問するか、残っている項目をユーザーに伝えてください。
3. 記入する
Skillツールを使用して、以下のモデル呼び出しスキルをこの順序で呼び出します:
source-recon:すべてのソースをproducts/<slug>/sources/にフェッチし、sources.lockに固定します。アクセス権限のためにフェッチが失敗した場合、正確なgitエラーを報告して停止します。ユーザーは自分のマシンでアクセス権限を修正します。決して資格情報を提供しないでください。product-kit:kit/tokens.css、フォント、アイコン、ロゴを抽出し、キャスト、名前、発音をキットとkit/RULES.mdに書き込みます。
どちらも製品フォルダ内にのみ書き込みます。sources/ 内のものは決して編集しないでください。
4. 報告
1つの短いテーブル、続いて次のコマンド:
| 項目 | 値 |
|---|---|
| フォルダ | products/<slug>/(git:最初のコミット、またはその理由) |
| ソース | sources.lock からのロール、ブランチ、コミット |
| キット | product-kit が抽出したもの、および見つからなかったもの |
| キャスト | 最終的な拒否権のための確定名 |
| 未解決 | product.yaml に残っているプレースホルダー、未確認のもの |
次:cd products/<slug> && claude、その後 /video-new <video>。