Communitygithub.com

jintomjose/mini-software-factory

將已提交的 intent.md 轉換為 spec.md(需求和設計合一的文件),並內聯標記策略關注點與待釐清決策。適用於擷取意圖之後、進入計劃模式之前。

mini-software-factory 是什麼?

這個技能會從 `work/<feature>/intent.md` 讀取意圖,並根據 `factory/templates/spec.md` 範本產生完整的 `spec.md` 文件。它強制在撰寫規格前先讀取 `CLAUDE.md` 及相關程式碼,避免遺漏實際約束。產出的規格包含按優先級排序的使用者故事(P1/P2/P3)、穩定的功能需求 ID(FR-XXX)與成功標準 ID(SC-XXX),並會以 `[NEEDS CLARIFICATION]` 和 `[POLICY: ...]` 格式內聯標記所有未決策與策略問題,絕不默默忽略。這個技能是 mini-software-factory 流程中的關鍵銜接步驟,支援 Claude Code 這類以文件驅動開發的工具,確保規格在提交後才能觸發計劃模式。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jintomjose/mini-software-factory/tree/HEAD/.claude/skills/write-spec

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

撰寫規格

輸入:work/<feature>/intent.md。輸出:work/<feature>/spec.md,根據 factory/templates/spec.md 範本產生。

  1. 讀取 intent.md、CLAUDE.md 以及變更會觸及的程式碼庫各部分。未閱讀程式碼就撰寫規格會遺漏約束;這是最常見的失敗原因。
  2. 按優先順序(P1、P2、P3)撰寫使用者故事。每個 P1 故事必須能獨立交付與測試。
  3. 為每個功能需求賦予穩定的 ID(FR-001),每個成功標準也賦予一個 ID(SC-001)。審查與測試都會引用這些 ID。
  4. 內聯標記,絕不默默解決:
    • [NEEDS CLARIFICATION: ...]:用於意圖未解決的任何決策
    • [POLICY: privacy | security | legal | money | brand]:在任何適用規則之處,附上該規則
  5. 設計章節只需寫到計劃所需的深度:資料變更、介面、狀態、錯誤情況。
  6. 列出明確 不屬於範圍 的事項。
  7. 展示規格,與人類逐一解決每個 [NEEDS CLARIFICATION],然後儲存。提交 spec.md 是觸發計劃模式的條件。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相關技能