agentic-sop-to-work
Turn human SOPs into deterministic, gated, human-approved agentic workflows — no fabrication, no "mega-agent" rot.
把人工 SOP 變成「確定性引擎 ＋ 誠實硬閘門 ＋ 人核准」的 agentic workflow——不臆造、不退化成 mega agent。
/plugin marketplace add s0912758806p/agentic-sop-to-work
/plugin install agentic-sop-kit@agentic-sop-to-work
/reload-plugins
🌐 English ・ 繁體中文
🗺️ At a glance · 運作一覽
flowchart LR
SOP["📄 Human SOP"]
SK["🔧 single-tool skills<br/>one tool · I/O contract"]
RUN["⚙️ run.py<br/>steps · branch · map · --plan"]
G{{"🚦 per-step gate<br/>cmd · schema · trace · recompute"}}
DR["📝 DRAFT"]
OK(["✋ human approval"])
STOPN["✗ stop & fix"]
REG[["🔁 Stop-hook regression<br/>change → tests → block & fix"]]
SOP -- decompose --> SK
SK -- orchestrate --> RUN
RUN --> G
G -- pass --> DR
DR --> OK
G -- fail --> STOPN
REG -. guards every change .-> SK
style OK fill:#E8F5E9,stroke:#2E7D32,color:#1B5E20
style G fill:#FFF8E1,stroke:#F9A825
style REG fill:#FFEBEE,stroke:#C62828,color:#B71C1C
Human SOP → single-tool skills → orchestrated flow (gated · branch · map) → DRAFT → human approval; a Stop-hook regression gate guards every change.
Human SOP → 單一工具 skill → 編排流程（閘門・分支・map）→ DRAFT → 人核准；Stop-hook 回歸閘門守住每次變更。
English
What. agentic-sop-kit turns a process you do by hand (a "Human SOP") into an agentic workflow an LLM can run safely and repeatably. A methodology + portable toolkit — not a chatbot. Built for regulated / high-stakes / must-be-correct work.
Why it's safe — it blocks the predictable LLM failures:
- Fabrication → facts come only from inputs; gaps marked
【待補】, never invented.
- Fake autonomy → deterministic work in code; hard gates are hermetic & LLM-free (self-eval only advisory, capped).
- Unaccountable output → every output is a DRAFT; controlled / high-risk calls stay human-owned.
- Mega-agent rot → an audit skill + a Stop-hook regression gate that re-verifies on every change.
What you get
| |
|---|
| 2 Skills (auto-trigger by intent) | agentic-sop — methodology + entry point · agentic-workflow-audit — read-only mega-agent auditor |
Command /agentic-sop-kit:sop-flow | runs the kit's orchestration, reports a DRAFT |
| Hooks (project-scoped) | SessionStart dep-check · Stop regression gate — no-op until a project adopts the kit |
Portable kit kit/ | copy-into-any-project methodology + runnable example |
Engine (run.py) — deterministic, code-decided, additive:
- Per-step gates (block on fail, zero LLM):
cmd_gate · schema_gate · trace_gate (no fabrication) · recompute_gate.
cmd steps (allowlisted; mutations need --allow-mutations) · --plan dry-run (lists every step + validates branch gotos).branch (forward-only) · map_over (per-item) — control flow in code, never the model.- Examples — dependency-free FE / BE / DB / AI flows in
kit/workflow/examples/.
Iron rules — facts only from inputs (【待補】 for gaps) · deterministic work in code, gates hermetic & LLM-free · DRAFT + human approval · gates check truth, not keywords. Real enforcement is the Stop-hook, not prose.
Install — in Claude Code (incl. Claude Desktop's Code tab):
/plugin marketplace add s0912758806p/agentic-sop-to-work
/plugin install agentic-sop-kit@agentic-sop-to-work
/reload-plugins # or restart the session
Requires Python 3.8+ as python3 (macOS/Linux out of the box; on Windows ensure python3 resolves). Verify: /help lists /agentic-sop-kit:sop-flow.
Build your own flow — adopt the kit: python3 <plugin>/kit/bootstrap.py --project <dir> → scaffold a step: new_skill.py --name <x> (fill DEPS / run()) → wire workflow/flow.json → make it conversation-triggerable: export_claude_skill.py --skill <x>. Details: kit/SOP.md.
Layout
agentic-sop-to-work/
├── .claude-plugin/marketplace.json
└── plugins/agentic-sop-kit/
├── .claude-plugin/plugin.json · skills/ · commands/ · hooks/
└── kit/ # portable kit: lib/ · workflow/ · tests/ · templates/ · examples/ · SOP.md
