skill-creator Go Skill 指揮稿(老闆下命令版)
這份文件是給使用者直接拿來下命令的。
語氣設計成「交辦任務」而不是「討論需求」。
重點只有一個:叫 skill-creator 直接把 Go skill 做出來,不准停在分析、提案、空談。
使用方式
直接把下面任一段貼給 Codex。
如果只想先丟一句話,就先用這句:
照 /home/shihyu/skill-creator-go-skill-prompts-boss.md 執行。不要跟我討論流程,直接做完。
通用總指令
每次都先補這段:
這是執行任務,不是討論題。
不要只給我分析、建議、規劃或選項。
直接開始做,先交最小可用版本,再補完整。
缺資料就先做合理假設,不要卡住。
該建檔就建檔,該改檔就改檔,該驗證就驗證。
quick_validate.py 要跑。
能補 evals 就補。
能跑 benchmark 就直接跑。
如果失敗就直接修,不要把錯誤原樣丟回來當結果。
最後只回報產物、路徑、驗證、benchmark 與待補強項。
指令 1:做一個 Go API skill
用 skill-creator 幫我做一個 Go API skill,現在就做,不要停在分析。
交付要求如下:
1. 基本資訊
- skill 名稱:go-api-builder
- skill 路徑:/home/shihyu/.codex/skills
2. 任務範圍
- 這個 skill 要處理 Go backend / HTTP API 開發與重構
- 內容必須涵蓋 router、handler、middleware、request validation、response shaping、problem details、service/repository 邊界、auth、timeout、context 傳遞
3. 觸發情境
- 建立 Go API endpoint
- 重構 Go backend / microservice
- 修 handler / middleware / validation / response format
- 整理 service / repository 分層
- 修 auth / timeout / error handling / API consistency
- 使用者提到 chi、gin、echo、net/http、REST API、problem details、repository pattern 時,要容易命中
4. 必須交付
- skill folder
- SKILL.md
- agents/openai.yaml
- 必要的 references/
- 需要時才建立 scripts/
5. 文件要求
- SKILL.md frontmatter 只保留 name 與 description
- description 要明確寫出做什麼、什麼情境該觸發
- body 要能拿來執行,不要寫成空泛教學文
- variant / framework-specific 細節拆到 references,不要全部塞進 SKILL.md
- 不要建立 README、CHANGELOG、QUICK_REFERENCE 這些多餘檔案
6. 驗證要求
- 做完立刻跑 quick_validate.py
- 失敗就修到過
7. 回報要求
- 告訴我 skill 建在哪裡
- 告訴我 description 為什麼這樣寫
- 告訴我 references 怎麼拆
- 告訴我驗證結果
指令 2:做一個 Go core skill
用 skill-creator 幫我做一個 Go core skill。不要把它寫成 Go 入門教材,要寫成能指揮 Codex 幹活的 skill。
交付要求如下:
1. 基本資訊
- skill 名稱:go-core-builder
- skill 路徑:/home/shihyu/.codex/skills
2. 任務範圍
- 聚焦 idiomatic Go、package 設計、cmd/internal/pkg 結構、consumer-side interface、dependency injection、error handling、context 傳遞、goroutine/channel 協調、效能敏感邏輯
3. 觸發情境
- 寫 Go 程式
- 重構 Go 專案
- 整理 package 結構
- 修 interface 邊界
- 修 concurrency / context / error handling / performance 問題
4. 必須交付
- skill folder
- SKILL.md
- agents/openai.yaml
- 必要的 references/
- 視情況建立 scripts/
5. 驗證要求
- quick_validate.py 要跑到過
6. 回報要求
- skill 路徑
- description 的 trigger 設計
- references 的拆分理由
指令 3:做一個 Go testing skill
用 skill-creator 幫我做一個 Go testing skill,直接做到可驗證,不要只交說明文件。
交付要求如下:
1. 基本資訊
- skill 名稱:go-testing-builder
- skill 路徑:/home/shihyu/.codex/skills
2. 任務範圍
- 涵蓋 unit test、table-driven tests、subtests、HTTP handler tests、integration tests、race detection、benchmark、fuzz、coverage
3. 觸發情境
- 使用者要求補測試
- 使用者要求修 failing tests
- 使用者要求補 benchmark / fuzz / race check
- 使用者要求測 API / handler 行為
4. 必須交付
- skill folder
- SKILL.md
- agents/openai.yaml
- references/
- 如果值得重用再建 scripts/
5. 驗證要求
- 跑 quick_validate.py
- 補 3 個 realistic evals
- 跑一次 benchmark
6. 回報要求
- skill 路徑
- eval 設計理由
- benchmark 結果
指令 4:重寫 description,提高觸發率
用 skill-creator 幫我重寫這個 skill 的 description,目標是提高觸發率。不要只提建議,直接改檔。
skill 路徑:
- /home/shihyu/.codex/skills/go-api-builder
要求如下:
1. 直接修改 SKILL.md frontmatter 的 description
2. 新 description 必須清楚覆蓋:
- Go API
- router / handler / middleware
- request validation
- response shaping / problem details
- service / repository 分層
- auth / timeout
- backend / microservice refactor
- API consistency / error handling / testability
3. description 要同時做到:
- 明確說出 skill 做什麼
- 明確列出哪些情境該觸發
- 即使使用者沒講 skill 名稱,也能靠任務語義命中
- 不要寫成雜亂關鍵字堆砌
4. 做完後:
- 跑 quick_validate.py
- 告訴我新舊 description 差異
- 告訴我這次怎麼補 trigger coverage
指令 5:補 evals,跑 benchmark
用 skill-creator 幫我補 evals,然後跑 benchmark。不要只停在設計檔案。
skill 路徑:
- /home/shihyu/.codex/skills/go-api-builder
要求如下:
1. 設計 3 個 realistic eval prompts,至少包含:
- 新增 Go API endpoint
- 重構 handler/service/repository
- 修 validation、timeout、error response consistency
2. 把 evals 寫進:
- evals/evals.json
3. 每個 eval 都要補 assertions
- assertion 要客觀、可驗證
- 名稱要清楚
- 不要模糊
4. 直接跑 with-skill 與 baseline 比較
- 新 skill baseline 用 without_skill
- workspace 請按 iteration 結構整理
5. 產出:
- benchmark.json
- benchmark.md
- review viewer
6. 最後回報:
- 哪些地方 skill 明顯贏 baseline
- 哪些 assertions 沒有鑑別力
- 哪些 eval 可能有高變異
- 下一輪最值得改的點
指令 6:一步做到位
用 skill-creator 幫我從零做一個 Go API skill,並一路做到 benchmark。不要停在分析,不要只交骨架。
任務如下:
1. skill 名稱:go-api-builder
2. skill 路徑:/home/shihyu/.codex/skills
3. skill 目標:
- 讓 Codex 處理 Go backend / API 任務時,採用固定且工程化的做法
- 涵蓋 router、handler、middleware、validation、problem details、service/repository、auth、timeout、context、testing
4. 必須觸發的任務:
- 建 API endpoint
- 重構 backend
- 修 validation / middleware / response format
- 改 service boundary / repository
- 修 auth / timeout / error handling / consistency
5. 必須完成的工作:
- 建 skill folder
- 寫 SKILL.md
- 產生 agents/openai.yaml
- 補 references/
- 必要時建立 scripts/
- 跑 quick_validate.py
- 建 evals/evals.json
- 補 assertions
- 跑 with-skill vs baseline benchmark
- 產生 review viewer
6. 品質要求:
- SKILL.md 精簡但能用
- description 要有足夠 trigger coverage
- references 要合理拆分
- 不要產生多餘文件
7. 最後交付:
- skill 路徑
- 驗證結果
- benchmark 結果
- 下一輪建議
極短版命令
懶得挑就直接丟這段:
用 skill-creator 幫我做一個 Go API skill,放在 /home/shihyu/.codex/skills。直接開始做,不要只給計畫。建立 skill folder、寫 SKILL.md、產生 agents/openai.yaml、補 references、跑 quick_validate.py,並補 3 個 realistic evals 跑一次 benchmark。description 要清楚覆蓋 Go API、handler、middleware、validation、response shaping、problem details、service/repository、auth、timeout、microservice refactor 等觸發情境。做完直接回報產物與結果。
壓最後一層的補刀句
如果對方還是想講流程,補這句:
我現在不是要你教我怎麼做,我是要你把東西做出來。直接改檔、補檔、驗證、跑 benchmark,最後回報結果。
最低限度也要講清楚的四件事
如果你不想失敗,至少別漏這四個:
skill 名稱skill 路徑觸發情境要不要跑 quick_validate / evals / benchmark
最差也要這樣下:
用 skill-creator 幫我做一個 Go API skill,放在 /home/shihyu/.codex/skills。直接建立 skill folder、寫 SKILL.md、產生 agents/openai.yaml、補 references、跑 quick_validate.py、補 evals/evals.json、跑 benchmark。不要停在分析。