需求釐清與驗收標準 Skill(Codex)
調查當前行為,在設計開始前將目標整理成已確認的產品需求、明確決策和驗收條件。
使用需求
面向具備倉庫及文件訪問能力的 Codex 類智能體。說明文件不提供瀏覽器、測試工具、憑據、項目數據或修改外部系統的權限;其他宿主可能需要適配。
- 明確目標及相關現有項目信息的訪問能力
- 能對權威資料尚未明確的產品問題作出決策的用戶
- 關鍵驗收條件依賴樣本時,需要用戶提供或指定的真實樣本
快速開始
- 下載後先檢查包內說明,再將 ZIP 解壓至暫存目錄。
- 安裝合集時,將六個 Skill 文件夾及同級 shared 文件夾複製到項目的 .agents/skills/ 或個人的 ~/.agents/skills/。保持相對目錄結構,不要把合集外層目錄當成一個 Skill 安裝。
- 安裝單獨 ZIP 時,將其中的同名文件夾放入所選 Skills 目錄,並保留其內部 shared 資源。覆蓋前備份同名 Skill,避免重複安裝。
- 在 Codex 中使用準確的 $talking-us 調用;未被發現時可重啟宿主。任務需要流程交接時,另行安裝相應配套 Skill。
適用場景
- 澄清新功能或已有行為變更
- 解決會影響實現的權限、歸屬、失敗恢復及邊界規則
使用步驟
- 調用 $talking-us,提供目標及實際項目;流程先調查相關事實,不把可自行查明的問題交給用戶。
- 明確角色、正常入口、輸入、規則、結果和恢復方式,分別記錄已確認、繼承、建議及未決事項。
- 回答剩餘獨立產品選擇;部分回答僅關閉對應子項,未解依賴繼續保留。
- 審閱需求草稿及驗收條件,取得可進入設計、部分就緒或被阻塞的狀態,以及未決問題和文檔位置。
字段命名與頁面文案
需求、前後端字段、頁面、接口和導出沿用常見、準確且一致的業務名稱,明確顯示標籤與既有標識的映射,不因改顯示名破壞公開契約。頁面默認不添加未經明確要求的解釋說明,也不將說明轉移到佔位符、Tooltip 或折疊區;必要標籤、校驗、狀態、錯誤與恢復反饋照常保留。單獨 ZIP 已包含所需共享參考。
交付內容
- 保存在實際項目 .talking-us/ 下、持續維護的詳細需求文檔
- 穩定的 REQ/AC 編號、決策和問題記錄及明確就緒狀態
局限
- 僅開展需求工作,不編寫開發設計,也不修改產品代碼、配置或數據。
- 現有行為是事實,不等於目標行為已獲批准;沉默和建議不等於確認。
- 缺少樣本或關鍵規則未定可能阻塞就緒;停止討論時交付草稿,而不是編造共識。
示例提示詞,非實際執行案例
使用 $talking-us 澄清本項目的導出功能。先檢查現有角色和導出行為,再向我詢問尚未確定的歸屬、格式、限額和失敗恢復規則,持續維護需求草稿。不要實現,也不要代我確定未決業務規則。
本指南說明包內工作流程,不代表已驗證跨模型可靠性,也不是實際驗收運行報告。
減少重複提問,保留完整規格
從目前有效的完整需求複製帶日期的新版本,沿用已確認規則及其必要推導,單列後續階段事實,只問會改變結果的未決業務取捨。完整草案交付前由獨立審查者追溯原始要求,核對必要性、事實依據和反例。
Skill 內部
SKILL.md
--- name: talking-us license: MIT description: >- Investigate current behavior, consolidate existing agreements, and clarify only unresolved business choices that affect users. Maintain a complete versioned requirements document for design handoff. Do not write the development design or edit the product. --- # Requirements Discussion Turn the user's goal into traceable product agreements with no known critical ambiguity. Apply existing context before asking about missing decisions. Use real tasks and counterexamples to check completeness. Investigate and maintain requirements only. Do not edit the product, configuration, database, deployment, or global terminology. Load write-design-doc, develop-closed-loop, test-case, or bug-fixing at the appropriate handoff. Use the user-specified skill version or the active entry point. Before writing or revising, read [complete-document versioning](shared/document-versioning.md). Start a new iteration from the effective complete baseline and integrate changes across the full document. Maintain one draft for the iteration. Establish the baseline and known gaps before asking the first question. ## 1. Investigate facts and filter decisions
包含檔案 · 19
talking-us/LICENSE talking-us/MANIFEST.json talking-us/README.md talking-us/SKILL.md talking-us/agents/openai.yaml talking-us/references/product-interaction.md talking-us/references/question-format.md talking-us/references/requirements-doc-template.md …