需求討論
調查當前行為,在設計開始前將目標整理成已確認的產品需求、明確決策和驗收條件。
使用需求
面向具備倉庫及文件訪問能力的 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 the current state, clarify product requirements, and confirm decisions about impact, business rules, permissions, interactions, and acceptance one by one to produce a detailed requirements document ready for design handoff. Use for requirements discussions and iterative clarification; do not write development designs or modify product code. --- # Requirements Discussion Turn the user's goals into product agreements with traceable sources and no known critical ambiguities. Establish completeness through user tasks and counterexamples, and confirmation through actual answers; do not judge readiness by the number of questions, document length, or model confidence. Only investigate and maintain requirements documents. Do not modify the product, configuration, database, deployment, or global terminology files. Load `write-design-doc`, `develop-closed-loop`, `test-case`, or `bug-fixing` only at handoff. Prefer the version specified by the user; otherwise use the currently enabled entry point. Do not load the entire set at once. ## 1. Investigate Facts First and Identify Decisions That Require Asking
包含檔案 · 15
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 …