메뉴
API 視圖的 Spec Skill（Reconciler）。從 .feature 文件推導 OpenAPI 格式的 api.yml。 每個 Feature 的 command/query 對應一個 endpoint。 以 desired-state reconciliation 模式運作：讀取現有 api.yml（若存在）→ 推導 desired state → 計算 diff → 增量更新。Greenfield 時 current = 空，等同於從零建立。 可被 /discovery 調用，也可獨立使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | aibdd-form-api-spec |
| description | API 視圖的 Spec Skill（Reconciler）。從 .feature 文件推導 OpenAPI 格式的 api.yml。 每個 Feature 的 command/query 對應一個 endpoint。 以 desired-state reconciliation 模式運作：讀取現有 api.yml（若存在）→ 推導 desired state → 計算 diff → 增量更新。Greenfield 時 current = 空，等同於從零建立。 可被 /discovery 調用，也可獨立使用。 |
| user-invocable | true |
| 方向 | 內容 |
|---|---|
| Input | ${FEATURE_SPECS_DIR}/**/*.feature (completed, no sticky notes) |
| Output | ${API_SPECS_DIR}/api.yml |
管理 API 視圖。以 reconciler 模式從 Feature Files 推導 OpenAPI 規格。
Reconciler 合約：啟動時 Read aibdd-core/references/reconciler-contract.md，全程遵循。
| 檔案 | 何時載入 | 內容 |
|---|---|---|
references/openapi-format.md | Step 1 Derive / Step 5 Apply | OpenAPI 格式範例、Path 命名、Status Code、型別推斷、CiC 分類 |
獨立調用時，先詢問：
${FEATURE_SPECS_DIR}）${API_SPECS_DIR}/api.yml）被 /zenbu-powers:aibdd-discovery 或 carry-on 調用時，由呼叫者提供以上資訊 + Execution Plan scope。
前提：所有輸入的 .feature 必須已完成（無便條紙、無 (待澄清) 佔位）。若發現未完成的 .feature，暫停並 REPORT 給協調器。
Read references/openapi-format.md 取得型別推斷與格式規則。
從所有 scope 內的 .feature 推導「api.yml 應該長什麼樣」：
| When 動詞 | Method |
|---|---|
| 建立、新增、送出、提交 | POST |
| 更新、修改、設定 | PUT / PATCH |
| 刪除、取消、移除 | DELETE |
Error schema：{ message: string }。Response envelope 依專案慣例。
Shared schemas 只在 create 時產生，modify 時不動。
讀取 ${API_SPECS_DIR}/api.yml。不存在 → current = 空集。
| 類型 | 條件 | 範例 |
|---|---|---|
| modify | endpoint 存在但 params/schema 不同 | GET /leads 加 score filter param |
| create | endpoint 不存在於 current | POST /scoring-rules 新增 |
| delete | current 有但 desired 無 | 需使用者確認 |
展示 diff 給使用者。格式見 reconciler-contract.md。
先改後增：modify → create → delete（需確認）。
遇到模稜兩可 → clarify-loop（AMB / GAP / ASM）。
寫入更新後的 api.yml + 回傳 change_summary（含 IMPL_IMPACT）。
每個 modify 操作評估對 implementation 的影響（格式見 reconciler-contract.md）：
| api.yml Diff | Impact Type | Phase | 影響目標 |
|---|---|---|---|
| Endpoint path / method 變更 | ENDPOINT_ROUTE | 05+06 | Backend route + Frontend URL + MSW handler |
| Request/Response schema 變更 | ENDPOINT_SCHEMA | 05+06 | Backend endpoint + Frontend form/display + MSW |
| Status code 變更 | ENDPOINT_SCHEMA | 05+06 | Backend error handling + Frontend error display |
| 新 endpoint（create） | NEW_OPERATION | 05+06 | 完整 TDD + Frontend 頁面 |
完成後交還呼叫者，回傳 change_summary（含 IMPL_IMPACT）：
/zenbu-powers:aibdd-form-entity-spec 完成 Entity 視圖驗收標準對齊評估方法論。給定用戶原始任務需求 + 上游 agent 產出，本 SKILL 提供萃取 testable criteria、4 大評估維度、報告格式、與 reviewer agents 的職責邊界、以及 WEB / 桌面 / CLI / 純文件的驗收手法分流。供 acceptance-evaluator agent 載入；orchestrator 直接 evaluate 簡單任務時也可參考。
Git diff 驅動的瀏覽器模擬人工測試工作流程。分析程式碼變更、映射影響範圍、使用 agent-browser 執行瀏覽器測試、錄製影片截圖、產出測試報告。
技術文件研究員的完整工作流程與規範。涵蓋文件爬取流程（Library / 主題兩種模式）、 品質規範與行為準則、SKILL 產出模板與驗收流程。 供 lib-skill-creator agent 執行文件研究與 SKILL 產出時載入。
Markdown 轉換的完整工作流程。涵蓋 markitdown MCP 轉換、圖片處理與上傳、 SVG/Mermaid 渲染、輸出品質處理與清理。 支援 PDF、Word、PowerPoint、Excel、HTML、圖片、音訊等格式。 供 markdown-creator agent 執行文件轉換時載入。
Agent 工廠。根據黃金法則創建符合最佳實踐的薄殼 Agent + 配套 Skills。 當用戶需要「建立 agent」、「新增 agent」、「create agent」、「設計 agent」、 「agent 工廠」、「造一個 agent」時使用此 skill。
Multi-pattern text search, filtering, and replacement using the Aho-Corasick algorithm. Use this skill whenever the user wants to: search for multiple keywords/patterns simultaneously in text or files, filter or detect sensitive words, scan multiple files for a list of terms, or redact/replace matched content. Triggers on phrases like "掃描關鍵字", "敏感詞過濾", "多個 pattern 搜尋", "批次掃描", "redact", "replace patterns", "keyword filter", "find multiple words", "scan files for patterns", or any task involving simultaneous multi-pattern matching. Always prefer this skill over naive grep loops when more than one pattern is involved.