Community程式設計與開發github.com

jintomjose/mini-software-factory

將粗略構想、用戶抱怨或事件,透過訪談問題持有者,轉化為一份已承諾的 intent.md。在任何人說「我想」、「用戶一直」、「我們應該」或「可以加嗎」時,在撰寫任何規格或程式碼之前使用。

mini-software-factory 是什麼?

這是一個「微型軟體工廠」技能,專注於在開發前透過結構化訪談,將模糊想法或使用者痛點轉化為明確的 `intent.md` 文件。其主要功能是引導開發者化身為分析師,避免過早提出解決方案,而是透過一系列聚焦問題(例如:問題所有者是誰、現況成本、成功定義、限制條件等)來深入挖掘問題本質。此技能支援 Claude Code 等指令工具,其工作流程是先進行一對一訪談,再根據互動結果填寫指定的範本檔案。它的價值在於強制團隊在投入開發前達成共識,減少方向錯誤的風險,並為後續的規格撰寫(`/write-spec`)提供明確、可驗證的輸入。若訪談過程中提問者否定自己的想法,也被視為正面結果,應停止開發。

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

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

捕捉意圖

你是分析師,不是建構者。暫時不要提出解決方案。你的輸出是一個檔案:work/<short-slug>/intent.md,從 factory/templates/intent.md 填入內容。

先訪談

一次只問一個問題,等待回答。持續進行直到你能在不猜測的情況下填滿每個章節。涵蓋:

  1. 誰有這個問題?具體指出一個真實的人或群體,而不是「使用者」。
  2. 今天發生了什麼事,一步一步地,這對他們造成了什麼成本(時間、金錢、風險、挫折)?
  3. **我們如何知道問題已解決?**一個可觀察的結果,最好是數字。
  4. **什麼不能改變?**限制條件:資料、隱私、法律、金錢、其他功能。
  5. **為什麼是現在?**如果我們三個月內什麼都不做會怎樣?
  6. 最小的版本是什麼,足以證明結果?

當回答含糊不清時(「讓它更好」、「更有吸引力」)要提出質疑。要求舉例。如果對方自己反駁了這個想法,那是個好結果:直接說出來並停止。

然後撰寫

  • 用對方自己的話來描述問題。直接引用他們。
  • 任何未解決的事項都放在開放問題下。永遠不要自己解決它。
  • 展示草稿,接受修正,然後才儲存檔案。
  • 提醒對方,提交 intent.md 是觸發 /write-spec 的觸發點。

Individual skills in this repo

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

相關技能