可實施開發設計

使用需求

面向具備倉庫及檔案存取能力的 Codex 類智能體。說明檔案不提供瀏覽器、測試工具、憑證、項目數據或修改外部系統的權限；其他主機可能需要適配。

已確認的需求、決策、驗收條件及相關樣本
可存取倉庫規則、實際程式碼、結構與遷移資訊及現有文件
完整產品設計需 develop-closed-loop 的交付參考文件；新頁面設計需未隨包提供的 frontend-design-lab
關鍵機制判斷需有可取得的實現依據或適度的獲授權檢查；機制探針不替代業務驗收。

快速開始

下載後先檢查包內說明，再將 ZIP 解壓至暫存目錄。
安裝合集時，將六個 Skill 資料夾及同級 shared 資料夾複製到項目的 .agents/skills/ 或個人的 ~/.agents/skills/。保持相對目錄結構，不要把合集外層目錄當成一個 Skill 安裝。
安裝單獨 ZIP 時，將其中的同名資料夾放入所選 Skills 目錄，並保留其內部 shared 資源。覆蓋前備份同名 Skill，避免重複安裝。
在 Codex 中使用準確的 $write-design-doc 呼叫；未被發現時可重啟主機。任務需要流程交接時，另行安裝相應配套 Skill。

適用場景

在實現已確認需求前準備開發設計。
審查既有設計中的復用假設、遺漏入口、契約衝突及恢復不確定性。

使用步驟

固定範圍、權威來源、決定、真實樣本與適用入口。按實際風險選擇驗證深度，明確的局部改動可使用簡短設計。
從擬復用或修改的機制反查呼叫方和消費者，包括旁路、後台任務及其它輸出，逐項說明受影響入口的歸屬。
通過實際實現、已有檢查或獲授權的最小隔離機制實驗，核實優先級、相容、冪等、原子性及恢復等關鍵保證。
用一套權威契約接通輸入、校驗、分支、狀態、持久化、可見結果與失敗恢復。欄位名稱常見且一致，保留必要反饋，只有用戶明確要求才添加解釋性頁面文案。
連續走讀正常、拒絕和恢復場景，用相關反例挑戰假設；修訂後重新核對受影響契約、呼叫方和結果。
最後判斷就緒，分別說明文件完整性、契約一致性與機制可行性，依據證據報告 READY FOR IMPLEMENTATION、PARTIALLY READY 或 BLOCKED 及局限。

交付内容

項目 .talking-us/ 或現有權威位置中的開發設計及適用數據庫、介面文件。
REQ/AC 映射、受影響入口歸屬、關鍵機制依據、明確未知項及待實現後執行的驗收。
包內包含設計驗證參考、欄位與文案共享規則，以及僅供維護時使用的七組評估樣例和獨立判據。

局限

不實現產品、不改配置或業務數據、不執行遷移，也不自動發布。唯讀檢查及隔離機制實驗受已有授權約束，不產生業務副作用。
機制探針不等於真實業務驗收。未來實現尚無運行驗收本身不阻塞設計就緒；核心保證未經核實則不能整體就緒。
文件可解析、連結存在或用例數量多，不等於機制可行或跨模型可靠。評估樣例用於維護，不是每次項目設計的必做項。

示例提示詞，非實際執行案例

使用 $write-design-doc，結合倉庫審查已批准的導出設計。反查所有呼叫方和消費者，用當前可取得的依據核實重試與相容假設，走讀失敗恢復反例並修訂權威契約。報告就緒狀態及未驗證邊界，不實現功能、不執行遷移。

Skill 內部

SKILL.md

---
name: write-design-doc
license: MIT
description: >-
  Write or review implementable development, database, and API designs from confirmed requirements and the actual project. Verify critical mechanisms, cross-layer contracts, and failure recovery before judging handoff readiness.
  Clarify missing product decisions first. Deliver design only; do not automatically develop the product or execute migrations.
---

# Implementable Development Design

Enable developers to implement from the design and understand the basis and limits of critical technical judgments. Document completeness, specification consistency, and mechanism feasibility are separate checks. State evidence for all three when judging readiness.

Maintain this task's design and authorized project documents, without changing product code, configuration, business data, or deployment. Within existing authorization, inspect current behavior, run existing targeted checks, or conduct minimal mechanism experiments without business side effects in a temporary isolated directory. This does not authorize real-data writes, paid external calls, or complete feature development.

## 1. Fix Scope and Choose Verification Depth by Risk

包含檔案 · 12

write-design-doc/LICENSE
write-design-doc/MANIFEST.json
write-design-doc/README.md
write-design-doc/SKILL.md
write-design-doc/agents/openai.yaml
write-design-doc/evals/cases.md
write-design-doc/evals/rubric.md
write-design-doc/references/design-invariants.md
…

可直接實施的開發設計