技能包

Monozukuri:用日式工藝流程讓 agent 寫出簡潔可驗證的程式碼

Monozukuri 最適合讓 agent 按日式工藝流程建構與維護簡潔、可驗證的軟體,但先確認你的 agent 支援 Agent Skills 格式,且官方未說明它是否會直接更動檔案、執行命令或連上網路。

官方來源 · kuya-egg/Monozukuri

安裝

npx skills add kuya-egg/Monozukuri --skill monozukuri-core

適合誰

  • 適合希望 agent 在寫程式時遵循一條可核查的流程(觀察→理解→計畫→實作→驗證→反思→改進),而不是一次性輸出程式碼的開發者。
  • 適合使用支援 Agent Skills 格式的 agent 的使用者:每個技能是頂層 <name>/SKILL.md 目錄,官方說明它相容任何支援該格式的 agent。透過 $monozukuri-core 明確呼叫。
  • 不適合的情況:證據未說明它依賴的具體執行環境版本、未列出經過驗證的用戶端清單,也未說明對文字/文件類任務的支援情況——本技能面向軟體建構與維護,證據未涉及其他用途時請勿假設。
  • 官方未說明的:支援的程式語言、是否需要網路存取、各技能的具體副作用邊界,均無證據,使用前自行確認。

3 分鐘完成第一次嘗試

前提:本機有 Node.js/npx;使用一個支援 Agent Skills 格式的 agent。官方提供兩種安裝方式,這裡只推薦一條主路徑:

主路徑:skills CLI 安裝核心技能

在專案根目錄執行:

npx skills add kuya-egg/Monozukuri --skill monozukuri-core

這只安裝傘技能 monozukuri-core。若之後想安裝全部 12 個技能(傘技能 + 11 個聚焦技能),官方的同一條 CLI 支援萬用字元:

npx skills add kuya-egg/Monozukuri --skill '*'

(官方另提供作為 Claude Code 外掛的安裝方式:/plugin marketplace add kuya-egg/Monozukuri 後 /plugin install monozukuri@monozukuri,會裝全部 12 個技能並以 monozukuri 命名空間載入;本文不把它並列為主路徑。)

觸發一次低風險任務:裝好後,在 agent 中明確輸入 $monozukuri-core,並給它一個小型唯讀/分析類任務,例如「按 craftsmanship 流程檢查某個小函式的正確性與簡潔性」。核心工作流程為 Observe → Understand → Plan → Craft → Verify → Reflect → Kaizen。

成功訊號:agent 沿用上述七個階段的流程組織回答,而不是直接丟出程式碼;聚焦技能按官方順序串聯(如 nemawashi → genchi-genbutsu → kanso → kata → poka-yoke → kodawari → andon → shukka)時,表示全部技能已生效。注意:本技能面向程式任務,不存在小說/專業文件的分路線 rubric;若你給它文字寫作任務,證據不保證有對應流程。$monozukuri-core 只是明確觸發方式,它是否讀寫檔案、執行命令或存取網路,官方未說明,第一次嘗試請選不會造成副作用的任務。

使用案例

案例一:小函式的工藝化檢查 情境:你想讓 agent 認真審視一段既有程式碼。發起方式:在支援的 agent 中輸入 $monozukuri-core,附上目標程式碼並要求按流程評估。使用的工作流程:傘技能的 Observe → Understand → Plan → Craft → Verify → Reflect → Kaizen。可期待結果:agent 分階段給出觀察、理解、計畫與驗證建議,而非直接改寫;至於是否需要你確認後才更動檔案,證據未說明,建議明確要求只分析不改檔案。

案例二:完整功能開發走聚焦技能鏈 情境:先安裝全部技能(--skill '*' 或 Claude Code 外掛方式),然後讓 agent 開發一個小功能。使用的工作流程:聚焦技能按官方順序 nemawashi → genchi-genbutsu → kanso → kata → poka-yoke → kodawari → andon → shukka 串聯,涵蓋從準備到驗證的完整鏈路。可期待結果:agent 按各技能的階段推進並給出每個階段的產出;各聚焦技能各自的觸發方式和具體副作用在證據中未展開,實際執行前向 agent 確認每一步是否會修改程式碼。

使用邊界

  • 安裝差異分平台:skills CLI(npx skills add ...)是通用路徑;Claude Code 平台使用 /plugin marketplace add + /plugin install monozukuri@monozukuri,安裝全部 12 個技能並帶 monozukuri 命名空間。不要把兩者混用或推斷其他用戶端的安裝方式。
  • 觸發方式:官方說明為明確呼叫 $monozukuri-core;其他技能的呼叫語法證據未給出。
  • 副作用與確認點:本技能會引導 agent 寫程式,但證據未說明它是否會直接修改你的檔案、執行命令或存取網路;這些均為未知。第一次嘗試優先唯讀分析任務,任何更動前要求 agent 先展示計畫。
  • 官方明確限制:monozukuri-core 單獨安裝只含傘技能流程;完整技能鏈需安裝全部 12 個技能。官方未給出支援的程式語言、語言環境、網路要求和用戶端清單。
  • 未確認的關鍵資訊:各聚焦技能的具體行為、更新/解除安裝方式、許可證外的使用條款,證據中均未涉及,使用前請查看儲存庫原文。