/product-new
在工作檯中建立一個產品資料夾:進行簡短訪談,然後執行一個腳本寫入資料夾,接著由兩個模型調用的技能來填寫內容(source-recon 負責擷取程式碼,product-kit 負責擷取標誌、字型、圖示、商標、角色和名稱)。
為什麼要先進行訪談?在這些技能所源自的實際製作流程中,角色、產品名稱和定位都是逐一審查才定案的,而每一次審查都迫使我們重新渲染。在這裡收集到的每一個答案,都代表未來不會再發生的審查回合。
開始之前
從這個技能的實際路徑解析工作檯位置(它能從工作檯和產品資料夾中執行):
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
從參數中檢查 slug:長度為 2 到 40 個字元,僅包含小寫字母、數字或連字號,且以字母開頭。如果 $PVS_HOME/products/<slug> 已存在,則停止並告知使用者:絕不覆寫產品,因為它有自己的記錄和可能已簽署的摘要。如果使用者傳入了 --from examples/acme(或其他資料夾),則訪談只需詢問與該範例不同之處。
在連接任何儲存庫之前,先向使用者說明一次:Claude 會讀取產品的程式碼,這表示程式碼會作為上下文發送給模型。使用者應確保其公司允許這樣做。
1. 訪談
以訊息為單位,分批提出問題(每則訊息兩到三個問題),並使用使用者的語言。盡可能為任何你能推斷的項目提供預設值,以便使用者大多只需確認即可。完整的問題清單及每個問題背後的動機,請參閱 references/interview.md;請在提問前先閱讀。
- 產品:名稱、用一句話說明它是什麼(定位)、目標使用者是誰。
- 禁語:團隊拒絕使用的描述,即使公司文件中有用到也不行。
- 原始碼:針對每個原始碼(前端、後端、設計、文件),提供 Git URL 或本機路徑、正式環境使用的分支、應用程式目錄及框架(
angular-primeng、react、vue、svelte、html、other)。詢問哪個分支是真正部署的:在原始製作流程中,一個過時的簽出就花費了實際的時間。 - 文件:URL、儲存庫路徑或
mcp:<name>(唯讀)。 - 品牌:僅當品牌資產(標誌和字型檔案)不在前端時才詢問。否則
product-kit會自行找到。 - 虛構角色:提議一家公司以及兩到三位人員,需包含全名、555 開頭的電話號碼以及使用
example/.test網域的電子郵件。用一個封閉式問題提供否決權,並以你的提案作為預設值。審查者對平淡或真實感過強的名字反應強烈,而一個在不同影片中姓氏會改變的角色,是一個會出貨的 Bug。 - 名稱與發音:官方名稱、現有 UI 中可能仍會顯示的舊版字串,以及品牌詞彙的發音方式。
- 禁止詞彙:競爭對手、供應商、真實客戶,以及任何絕對不能出現或被聽到的內容。
- 審查者:負責簽署每部影片的覆蓋率矩陣和索賠表的人員。
切勿要求提供 token、密碼或 SSH 金鑰,也絕不要提議儲存這些資訊。原始碼是使用機器上已有的 Git 存取權限來擷取的。如果 URL 中包含憑證(https://user:token@...),請要求使用者移除它們;腳本無論如何都會拒絕這類 URL。
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 提交。該腳本會拒絕處理已存在的 slug、包含憑證的 URL,以及明顯非虛構的角色電子郵件或電話。如果執行失敗,請修正它指定的答案並重新執行;不要手動建立資料夾。
如果腳本輸出「still to fill in product.yaml」,表示訪談未涵蓋到範本中的佔位符。詢問這些佔位符的內容,或告知使用者哪些項目尚未填寫。
3. 填寫資料
透過技能工具(Skill tool)按下列順序呼叫這些由模型調用的技能:
source-recon:將每個原始碼擷取到products/<slug>/sources/中,並將其固定記錄在sources.lock中。如果因存取問題導致擷取失敗,請報告確切的 git 錯誤並停止:使用者應在他們的機器上修復存取權限,絕不應由你提供憑證。product-kit:擷取kit/tokens.css、字型、圖示、標誌,並將角色、名稱和發音寫入 kit 和kit/RULES.md中。
這兩項技能都只會在產品資料夾內寫入內容。切勿編輯 sources/ 中的任何內容。
4. 報告
一個簡短表格,接著是下一個指令:
| 項目 | 值 |
|---|---|
| 資料夾 | products/<slug>/(git:首次提交或原因) |
| 原始碼 | 角色、分支、來自 sources.lock 的提交 |
| 套件 | product-kit 擷取的內容,以及它找不到的內容 |
| 角色 | 已確定的角色名稱,供最終否決 |
| 待辦事項 | product.yaml 中仍為佔位符的項目,以及任何未驗證的內容 |
下一步:cd products/<slug> && claude,然後 /video-new <video>。