agentic-sop
/agentic-sop
Use when turning a human SOP or manual process into an agentic workflow, building or adding an agent tool, or starting a new agent-workflow project — even if the user never says 'SOP' or 'methodology'. | 要把人工流程/SOP 自動化、建立或新增 agent 工具、或開一個新的 agent 工作流專案時使用;只要意圖是把流程工程化成自動代理就觸發。不適用:稽核既有工作流是否退化成 mega agent(改用 agentic-workflow-audit)。
- Author
- s0912758806p ↗
- Repository
- agentic-sop-to-work ↗
- Licence
- MIT
- Last repository change
- 08.09.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 08.09.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Use when turning a human SOP or manual process into an agentic workflow, building or adding an agent tool, or starting a new agent-workflow project — even if the user never says 'SOP' or 'methodology'. | 要把人工流程/SOP 自動化、建立或新增 agent 工具、或開一個新的 agent 工作流專案時使用;只要意圖是把流程工程化成自動代理就觸發。不適用:稽核既有工作流是否退化成 mega agent(改用 agentic-workflow-audit)。
Triggers from the description
Original author description
Use when turning a human SOP or manual process into an agentic workflow, building or adding an agent tool, or starting a new agent-workflow project — even if the user never says 'SOP' or 'methodology'. | 要把人工流程/SOP 自動化、建立或新增 agent 工具、或開一個新的 agent 工作流專案時使用;只要意圖是把流程工程化成自動代理就觸發。不適用:稽核既有工作流是否退化成 mega agent(改用 agentic-workflow-audit)。
How it works
- 何時用 / 不用
- 開場:先判斷輸入型態(intake 分流)
- 核心模型(三段鏈,缺一不可)
- 拆解完,先畫拓撲(動手接線之前)
- 落地:導入 agentic-sop-kit(不要重造)
- 跨專案鐵則(為什麼)
- 「保證遵守」來自 hook 與靜態閘門,不是這支 skill
SKILL.md preview
--- name: agentic-sop description: Use when turning a human SOP or manual process into an agentic workflow, building or adding an agent tool, or starting a new agent-workflow project — even if the user never says 'SOP' or 'methodology'. | 要把人工流程/SOP 自動化、建立或新增 agent 工具、或開一個新的 agent 工作流專案時使用;只要意圖是把流程工程化成自動代理就觸發。不適用:稽核既有工作流是否退化成 mega agent(改用 agentic-workflow-audit)。 --- # Agentic SOP — 把人工流程做成可治理的 agent 工作流 ## 何時用 / 不用 - **用**:要把人工 SOP/手動流程自動化、建新 agent 工具、設計「拆解+閘門」、或開新的 agent 工作流專案時。任何專案皆適用,尤其未來新項目。 - **不用**:稽核既有工作流是否退化成 mega agent → 用 `agentic-workflow-audit`;執行既有 GMP 產生器 → 用該工具自己的 skill。 ## 開場:先判斷輸入型態(intake 分流) 觸發後**第一件事**——看使用者怎麼來,別急著動工: - **已有正式輸入**(寫好的 spec/既有 requirement 或 runner skill/已填好的 `templates/human_sop_template.md`)→ **照原樣採用**、不重寫,直接進下面的拆解。 - **只有自然語言需求/任務** → 先用 `templates/human_sop_template.md` **起草一份 Human SOP**:能由輸入得到的填上、未知的標【待補】(**絕不臆造**);草稿好 **STOP 給人看一眼**(「這樣有抓到你的流程嗎?改/確認」)→ 確認後才續入拆解。 - **判不準** → 問一個澄清問題,別猜路。 草稿 SOP 也是 **DRAFT**(受「DRAFT+人核准」約束);本步只動生成層,**不碰引擎/閘門**。 ## 核心模型(三段鏈,缺一不可) Human SOP → **工具 Skill(SKILL.md)** → Agentic Workflow(**拓撲宣告** + 誠實閘門 + hook)。 中間的 Skill 環最易被忘:**工具一改,SKILL.md 必須同次更新**。每支工具實作同一條七階段迴圈: intake → 分類/前置檢查 → 確定性層(程式) → 生成層(Claude,只整理輸入) → 組裝 DRAFT → 閘門自評(≤2 次) → 覆核包 → 人核准 STOP。 ## 拆解完,先畫拓撲(動手接線之前) 拆出節點之後、寫 `flow.json` 之前,**先把圖講清楚**——這一步只花幾分鐘,卻是後面所有閘門的地基: 1. **節點**:列出每個節點(=一個工具的一步)。 *節點不是 agent*:把工具換成模型的節點常被叫做 agent,但**一 skill 一工具**不變; 一個節點裡塞了整條流程就是 mega agent,名字叫什麼都一樣。 2. **邊**:每條邊**取一個名字**——「誰把**什麼**交給誰」。交接的是具名產物,不是「整包 context 丟過去」。 接著給它型別(`schema_ref` 指向 `workflow/schemas/<tag>.json`):邊沒有型別,交接協定就是假的。 3. **狀態欄位與 owner**:列出流程要共用的欄位,**每個欄位指定唯一一個 writer 節點**; 讀取方宣告 `reads`。值不另外存——留在該節點的 artifact 裡(`written_by` 就是 `produced_by`)。 4. **退回邊**:哪一步的判定會把工作**退回**上游?那條邊宣告 `back:true` + `max_revisits:<N>`。 沒有上界的環不准存在;退回的判定必須由**確定性的欄位**決定,不是由模型當場決定。 5. **驗證**:`python3 workflow/run.py --plan` 會把整張圖靜態判過(不可達節點、read-before-write、 寫入衝突、無界環、孤邊),不合法在跑之前就 exit 2;`--graph` 畫出來給人看。 > 五題有任一題答不出來,就是還沒拆完——**別急著寫 flow.json**。 > 若流程本來就是一條直線、也沒有退回,那就照直線做:以上宣告全是選擇性的,不宣告即維持線性行為。 ## 落地:導入 agentic-sop-kit(不要重造) 方法論已封裝成可攜套件,**直接導入、別重寫**: 1. 一鍵導入:`python3 ~/.claude/agentic-sop-kit/bootstrap.py --project /path/to/project`(複製 kit+裝 `/sop-flow`+合併 Stop-hook)。canonical 在 `~/.claude/agentic-sop-kit/`。 2. `python3 agentic-sop-kit/check_deps.py` 驗依賴;`workflow/run.py` 跑通範例。 3. 用 `templates/human_sop_template.md` 寫 SOP(每步標工具);依拆解規則把每個「步驟×工具」用 `templates/skill_template/` 建成 `skills/<name>/`。 4. 依上一節的拓撲在 `workflow/flow.json` 接線(節點順序、`schema_ref`、`reads`/`writes`、退回邊); `--plan` 驗過再跑;裝 `commands/` + `hooks/`。 詳見 kit 的 `SOP.md`(方法論 canonical)與 `README.md`(安裝);圖示範流程見 `workflow/examples/graph.json`。 ## 跨專案鐵則(為什麼) - **事實只來自輸入**,缺標【待補】,絕不臆造編號/日期/姓名/結論——臆造會在下游被當成事實,汙染整條鏈。 - **確定性的事用程式、不用 LLM**;硬閘門必須確定性、hermetic;LLM 自評一律 advisory 且封頂於確定性——否則模型替自己放水(弱閘門=假自主)。 - **DRAFT + 人核准 STOP**;受控/高風險判定永遠人擁有。 - **閘門查真相、不查形式**:別用 token 重疊/關鍵字出現/grep 編號當硬閘門(可被字詞游戲化),要對權威來源核對。 - **共享狀態必須有契約**:每個欄位唯一 writer、讀之前所有路徑保證寫過、邊上產物有型別。 沒有這三樣的「大家共用一個 dict」就是黑板,會讓錯誤來源無法歸屬。 - **環必須有界**:退回邊一律宣告上界,且上界寫在**程式**裡而不是 prompt 裡; 進度用產物內容量測(沒變就是沒進度),不是數次數——雙終止,先到者停。 ## 「保證遵守」來自 hook 與靜態閘門,不是這支 skill 本 skill 是**提醒與指引**(散文,機率性)。真正的強制力有兩處,都不在散文裡: - **Stop-hook 自動回歸**:更新後有變動才跑「受影響單元+整合」兩層,fail 就 `decision:block` 把原因餵回去修,附重試上限防迴圈。要讓某專案「真的被擋」,就把 kit 的 `hooks/`(SessionStart 依賴檢查 + Stop 回歸)裝上。 - **靜態拓撲閘門**:`run.py --plan` 對不合法的圖 exit 2(`lib/graph.py`),且執行期同樣拒跑—— 上面那些拓撲鐵則之所以是鐵則,是因為它們有這道確定性的閘門,不是因為這裡寫了。
Versions
The database has no other skills named agentic-sop.
Database snapshot: 13.11.2026 · package version 971cf008945f (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100agentic-workflow-audit
Use when reviewing or auditing an existing agent / LLM-pipeline architecture — e.g. 'is my workflow actually decomposed or secretly a mega-agent?', 'are my task boundaries and success criteria right?', 'is our shared state a blackboard?', 'can this retry loop run forever?' —… - 100ai-workflow-architect
Design practical AI workflows, agents, automations, SOPs, and human approval loops for business operations. Use when turning a manual process into an AI-assisted workflow, mapping tools and data sources, deciding what to automate versus keep human, creating an implementation… - 100sop-to-ai-workflow
Turn a supplied SOP and sample files into a repeatable AI-assisted workflow and complete one work sample. Use when automating a manual business process, defining review points, or separating file work from system integration. - 90workflow-builder
搭建、改进或审计可复用的 AI/智能体业务工作流,覆盖场景选择、角色与工具边界、异常处理、真实试跑、人工验收、SOP 沉淀、知识库及跨工具复用。用户提出“搭建/优化工作流”“把重复任务流程化”“检查流程能否闭环”或 workflow design/audit 时使用;仅在用户要求按既有流程执行时才用于执行,不为普通一次性任务强行搭建流程。 - 90cc-sdd-new-agent
Add or extend coding-agent support in cc-sdd by executing the SOP in docs/cc-sdd/sop-new-agent.md end-to-end. Use when introducing a new agent, adding a subagent-capable variant, or evaluating migration of an existing supported agent to skills-based templates. - 100add-workflow
TRIGGER when user asks to define a workflow graph, create an agent or agentic workflow, orchestrate tasks, or build a multi-step process. "Agent", "agentic workflow", and "workflow" are interchangeable here - an LLM is not required for a workflow to be an agent (rule-based,…