six-rung-ladder
Use when deciding whether to write a piece of code, add a dependency, or introduce an abstraction / module / config — the "should I build this at all?" filter, applied before building. | 要決定「要不要寫這段 code/引這個依賴/加這層抽象或模組」時使用——「到底該不該做」的過濾網,動手之前先走一遍。不適用:把流程做成 agent workflow/建工具(改用 agentic-sop);稽核既有架構有沒有拆好(改用 agentic-workflow-audit)。
- License 许可
- MIT
- 最近更新
- 2026-10-30
- Stars
- ★ 211
- Forks
- 21
01 前言 Front Matter
- name
- six-rung-ladder
- description
- Use when deciding whether to write a piece of code, add a dependency, or introduce an abstraction / module / config — the "should I build this at all?" filter, applied before building. | 要決定「要不要寫這段 code/引這個依賴/加這層抽象或模組」時使用——「到底該不該做」的過濾網,動手之前先走一遍。不適用:把流程做成 agent workflow/建工具(改用 agentic-sop);稽核既有架構有沒有拆好(改用 agentic-workflow-audit)。
03 SKILL.md 正文
極簡架構過濾網:Six-Rung Ladder
角色與目標
面對任何「要不要寫這段代碼/要不要引入這個東西」的決策時,當一道逐級過濾網。核心信念:Lazy, not negligent(慵懶,但絕不疏漏)。每一行代碼、每一個依賴、每一個抽象,都是未來的維護成本與攻擊面;最便宜、最安全的代碼,是那行你沒有寫的。
這把梯子是 decide → build → audit 方法論的最前段:先用它擋掉不該做的,剩下該做的才交給 agentic-sop 去建、agentic-workflow-audit 去查。
怎麼用
請求從第 1 級開始往下走,能在哪一級攔下,就在哪一級解決,絕不下沉。一旦某級給出可行解就停,不要繼續往下找更重的方案。
1. YAGNI — 業務真的需要嗎?
不需要 → 直接拒絕。先質疑需求本身,而不是急著找實現方案。
2. Stdlib — 標準庫能解決嗎?
優先用語言/執行環境的原生標準庫:大規模驗證、零供應鏈風險、零安裝、隨語言一起維護。
這一級在本專案是機械化的,不是口號:engine 純標準庫由
kit/tests/test_no_third_party.py守(回歸時 fail-loud),整個 marketplace 的 stdlib-only 不變量由plugin-forge lint --all --strict守。
3. Native Platform — 平台原生特性夠用嗎?
引入任何函式庫之前,先確認平台是否已提供(瀏覽器 fetch / URL / Intl、CSS 原生特性……往往足以取代一整包依賴)。
4. Installed Dependency — 現有依賴能複用嗎?
前三級都不行,先翻一遍已經裝好的依賴。堅決不為了一個小功能引入新的供應鏈風險——每個新依賴都是新的版本維護、安全漏洞與授權問題來源。
同第 2 級:新依賴會被
test_no_third_party/plugin-forge lint擋下——這一級有 gate,不靠自律。
5. One Line — 一行乾淨代碼行不行?
與其引入抽象、新模組或新依賴,不如就地寫一行清晰直白的代碼。前提:乾淨、可讀、意圖明確,而非炫技式壓縮。
6. The Minimum That Works — 最小可用閉環
全走不通 → 只寫最小可用、能跑能驗的閉環。不過度設計、不預留花俏擴展點;先讓最小版本真正運作起來。
死守紅線:Lazy, not negligent
「慵懶」是對複雜度/抽象/依賴保持吝嗇;「絕不疏漏」是有些東西一行都不准省。下列防禦性代碼永遠不適用上面的偷懶哲學:
- 跨信任邊界的防注入:任何外部資料(用戶輸入、第三方回應、檔案內容、URL 參數……)一律當作不可信,做好校驗與轉義。
- 容災與錯誤處理:失敗路徑、超時、重試、降級,該寫的都要寫,不能假設一切正常。
- 安全性:權限校驗、機密處理、最小權限原則,不能因「先跑起來再說」而跳過。
這條紅線與本專案既有鐵則「防禦代碼不准省」是同一條;對應的確定性 gate(如
trace_gate防臆造)亦屬此列。在該懶的地方懶到極致,在該嚴的地方一步不讓。
速查口訣
| 級別 | 名稱 | 一句話 |
|---|---|---|
| 1 | YAGNI | 業務真需要嗎?不需要就拒絕。 |
| 2 | Stdlib | 標準庫能不能搞定?(有 gate) |
| 3 | Native Platform | 平台原生特性夠不夠用? |
| 4 | Installed Dependency | 現有依賴能不能複用?(有 gate) |
| 5 | One Line | 一行乾淨代碼行不行? |
| 6 | Minimum That Works | 都不行就寫最小可用閉環。 |
紅線:防注入、容災、安全性 — 防禦代碼不准省略。
輸出格式
被觸發時,對該決策逐級回報:在第幾級攔下、為什麼、具體方案(或:為何必須下沉到下一級)。若涉及外部輸入/失敗路徑/安全,明確點出哪條紅線項不得偷懶。最後一句結論:做 / 不做 / 做最小版。
04 同仓库更多 Skills
second-opinion
Use when asked to get a second opinion on a finished DRAFT, fact-check or double-check a report's claims against its evidence, sanity-check before sign-off, or red-team an output for fabrication / overreach / invented IDs — even without the word "honesty". Works on an agentic-sop-kit run dir (FULL, uses the run's trace) or any plain document (DEGRADED, you supply the inputs). | 要對一份已完成的 DRAFT 取得「第二意見」、在核准前查核報告主張是否有輸入佐證、抓臆造/灌水/過度宣稱/捏造編號時使用;吃 agentic-sop-kit 的 run 目錄(FULL,用 trace)或任何純文件(DEGRADED,需自備輸入)。不適用:稽核 agent 架構有沒有拆好/是不是 mega-agent(改用 agentic-workflow-audit);審查原始碼品質/bug/資安(改用 /code-review)。本 skill 只查「這次產出的主張 vs. 證據」誠實度,只產 DRAFT,核准永遠人擁有。
plugin-forge
Use when creating, scaffolding, or linting a Claude Code plugin — generate a grammar-conformant plugin skeleton, or validate a plugin / whole marketplace against house invariants (manifest, frontmatter, stdlib-only, hook protocol, test harness). | 要新建 / scaffold 一個 Claude Code plugin,或 lint 既有 plugin / 整個 marketplace 是否符合房規時使用。
good-plugin
demo good plugin
bad-plugin
暂无简介
alcoa-guard
Use when checking a record / dataset / GMP document for ALCOA+ data integrity — attribution, contemporaneity (backdating), completeness, accuracy (recompute / in-spec), consistency — before a human approves. DEGRADED mode lints any CSV/JSON record against a declared .alcoa.json contract; FULL mode snaps onto an agentic-sop-kit run dir. | 要檢查紀錄/資料/GMP 文件的資料完整性(ALCOA+:可歸屬、同步性/防 backdating、完整、正確、一致)時使用。輸出為 DRAFT,人擁有最終判定;確定性檢查只覆蓋可機械驗證的部分,其餘列為人判斷清單,絕不臆造。
sop-flow
Run the agentic-sop-kit workflow (extract→compute→report, or a declared topology) and report the DRAFT result. Works out-of-the-box (bundled demo) even before a project adopts the kit.