📚 SUMLINK Wiki

工作流登記冊(Workflow Registry)

目的:每個重要工作流列出「權威文件/執行腳本/台賬/改動同步清單」。 改任何工作流前先查本冊,跟「改動要同步」清單逐份改,唔使全檔 grep(T-189 教訓:Insights 審核由 Claude 改 Codex 要 grep 8 處先齊)。 維護:default(基礎設施管家)。每次工作流改動完成後必須回填本冊「改動記錄」。 建立:2026-09-30(T-190,Ken 拍板方案 A)。相關:team-workflow-rules、SCHEMA。

使用方式

  1. 收到「改工作流」指示 → 喺本冊搵對應工作流 → 睇「改動要同步」欄 → 逐份檔案改。
  2. 改完 → 更新「台賬」指到嘅 tasks*.md 狀態 → 喺 log.md 記一筆 → 回填本冊「改動記錄」。
  3. 涉及 cron 腳本嘅改動 → 改完用 python -m py_compile 驗證語法,確認 cron 下次跑用新邏輯。
  4. 涉及台賬/看板狀態 → 改完立即重跑 wiki 發布(B1),Ken 會盯手機版新鮮度。
  5. 涉及多份 SOUL/規矩檔 → 全部 profile(default/admin/siteops/cs)逐份改,唔好漏。

路徑約定:[scripts] = C:/Users/Ken/AppData/Local/hermes/scripts/;[repo] = E:/AIAgent/sumlink-hk/; [vault] = E:/AIAgent/obsidian/;cron 一律以 hermes cron list 為準。

工作流清單

A. 內容/發布類

# 工作流 負責 權威文件 執行腳本/cron 台賬/記錄 改動要同步
A1 Insights 內容工作流(每 5 日 1 篇 → Codex 審核 → 發布) admin 寫作 → siteops 發布 [repo]docs/promotion-plan.md §2.3A(roadmap+審核關卡) [scripts]insights_cadence_tick.py(cron insights-cadence-5d d6d525106ce4)、insights_roadmap_review.py(cron insights-roadmap-monthly d26ca57b6885) tasks T-049/T-088 系列、tasks-ref、tasks-board「Promo 工作流」節、log promotion-plan ↔ 兩個 cron .py ↔ tasks.md ↔ log.md;審核關卡變更*要連同 live kanban 卡(promo board)comment+unblock(T-189 8 處案例)
A2 網站修改工作流(Webflow) 站長 siteops(唯一 Webflow 操作者) team-workflow-rules §Webflow 操作規則 siteops skills:webflow-site-ops(webops 類)、webflow-siteops、webflow-ops(webflow 類);wf_mcp 工具 web board、tasks*.md、website-changelog、log team-workflow-rules ↔ siteops skills ↔ web board ↔ website-changelog;token 修復後必查有冇因 token block 嘅卡(T-186 教訓)
A3 品牌視覺/圖像生成 admin(運營腦) brand-visual-spec、lighting-design-rules、media-generation-pipeline、hero-production-lessons 火山 seedream(plan 額度)/Gemini Enterprise;media board tasks*.md(T-06x/07x/17x 系列)、log brand-visual-spec ↔ lighting-design-rules ↔ media-generation-pipeline ↔ 生圖通道配置(memory 有記錄)
A4 SEO/內容指標監控 admin [repo]docs/promotion-plan.md §6 KPI [scripts]check_seo_thresholds.py(cron 159aeee9e1b9 30m)、check_content_metrics.py(cron 924d3a61f4df 09:30) promotion-plan §6、tasks promotion-plan ↔ 兩個 check .py ↔ 台賬

B. 基建/監控類

# 工作流 負責 權威文件 執行腳本/cron 台賬/記錄 改動要同步
B1 知識庫發布(Obsidian → pages.dev 手機版) default [vault]SCHEMA.md(=SCHEMA) [scripts]wiki_daily_update.sh(cron wiki-daily-update f8d3df15de29 每日 08:00)= build_wiki_site.py + style_tasks_board.py + wrangler deploy sumlink-wiki2 sumlink-wiki2.pages.dev、tasks-board.html 台賬 tasks.md 改完 → 即時重跑* wiki_daily_update.sh(Ken 要求,stale 會被指正)
B2 網站 vs 庫每日對帳(T-157) default [repo]docs/site-vs-library/ 日報 [scripts]site_vs_library_reconcile.py(cron T-157-網站與知識庫每日對帳 9e38bdb5e31b 每日 08:30) tasks T-157、日報目錄 reconcile .py ↔ 日報目錄 ↔ tasks.md(3 日未修自動升級)
B3 Gateway 監控/重啟 default hermes/AGENTS.md(鐵律:禁殺自己進程、只准 hermes gateway restart) [scripts]check_gateway_pid.py(cron 9f6c6afe21ce 30m)+ gateway watchdog gateway.log、gateway.pid AGENTS.md ↔ check_gateway_pid.py ↔ SOUL §監控
B4 NAS 備份 default nas-backup-automation skill E:/AIAgent/ops/zspace-backup/backup.ps1(Windows 排程 03:00)、[scripts]zspace_sync_check.py(cron 253350607afc 09:00);D: 本地快照 3 日+syncthing sendonly+每晚 /rest/db/scan 備份日誌、tasks skill ↔ backup.ps1 ↔ zspace_sync_check.py
B5 Webflow token 監控 default —(暫無權威檔) [scripts]check_webflow_token.py(cron 8ccf3b4af221 30m;failure_deliver=local) tasks、log 修復 token 後必查 kanban 有冇 block 卡(T-186 教訓)
B6 模型配置/高峰調度 default model-config-review-20260918、default-model-ab-20260922、siteops-cs-model-downgrade-20260923、thinking-model-matrix [scripts]fallback_peak_flip.py(cron b9be88ed4cdc */5)+ hermes config set;A/B 品牌視覺限額 memory(火山 plan 配置)、tasks concepts 模型文件 ↔ fallback_peak_flip.py ↔ memory 記錄 ↔ config.yaml
B7 Obsidian 三頁自動刷新(website-changelog/products-status/selection-matrix) default [repo]docs/obsidian-status-pages-maintenance.md(T-169) [scripts]refresh_obsidian_status_pages.py(cron obsidian-status-pages-refresh 8fa70d3e1d38 每日 08:40;對應生成器 [repo]scripts/build_obsidian_status_pages.py) website-changelog、products-status、selection-matrix 生成器 .py ↔ 三頁 ↔ maintenance 文檔 ↔ 改完即重跑+發布(B1)

C. 系統/流程類

# 工作流 負責 權威文件 執行腳本/cron 台賬/記錄 改動要同步
C1 任務生命周期/看板流程(四檔同步) 全部 team-workflow-rules + 各 profile SOUL §一 kanban 內建(dispatcher 60s/notifier 5s) 四檔:kanban 卡 ↔ tasks ↔ tasks-ref ↔ tasks-board(+證據) team-workflow-rules ↔ 4 份 SOUL(default/admin/siteops/cs)↔ tasks*.md;改動後重跑 wiki(B1)
C2 定時任務規矩(【定時 …】) 全部 SOUL §〇 + team-workflow-rules §定時任務規矩 hermes cron(ISO 時間戳一次性;"10m"=重複陷阱;scheduler tick ≈60s 延遲) cron list、定時任務 topic(thread 2868) SOUL ↔ team-workflow-rules ↔ cron 設定
C3 編碼三階段流水線(方案→Codex 執行→審核) admin admin SOUL §編碼流水線 + admin skills a2a-coding-pipeline + team-workflow-rules §編碼三階段 A2A bridges:Codex :8756(scheduled task Hermes_A2A_Bridge)、Claude :8757(Hermes_A2A_Bridge_Claude) a2a-bridge-ops.md、tasks*.md admin SOUL ↔ a2a-coding-pipeline skill ↔ team-workflow-rules ↔ bridge 排程
C4 dsh 產品數據管線 default/admin product-data-pipeline skill(default)+ dsh board dsh 管線腳本:[repo]scripts/dsh/*.py(hcl_rules_engine、extract_model_specs、constraints_from_dsh…)+ [repo]scripts/enhance_bom_config.py dsh board、[repo]data/dsh_migrated/*.csv+field_source.csv、tasks*.md skill ↔ dsh board ↔ field_source.csv ↔ tasks*.md
C5 Kanban 健康監控 default — [scripts]kanban_daily_summary.py(cron 4159b8ded888 08:00)、kanban_offpeak_release.py(cron c641aa4c171b */30)、kanban_watch.py、kanban_p0_watch.py、check_taskcard_fields.py(cron 49df1accaf95 09:30)、check_task_dod.py(cron 8664ae36509c 30m)、check_bot_polling_conflict.py(cron ef6d9eb4fdc8 30m) 定時任務 topic(2868)、log 腳本 ↔ 台賬 ↔ log.md
C6 通知渠道分工(DM/看板 topic 1863/定時任務 topic 2868) default(cron 設定者) team-workflow-rules §通知渠道分工 hermes cron create --deliver/--failure-deliver 參數 cron list、TG topic 1863/2868 team-workflow-rules ↔ 4 份 SOUL ↔ cron 設定(deliver 目標改動要 4 份 SOUL 齊改)
C7 誠實匯報規矩(驗證等級三級+四欄+看板四段格式) 全部 team-workflow-rules §二§三 無(格式紀律,非腳本) 看板 topic 1863、kanban summary team-workflow-rules ↔ 4 份 SOUL ↔ kanban complete summary 寫法
C8 Peer 互聯(員工 bot 直通) default=client;admin 8642/siteops 8643/cs 8644 各 profile SOUL §四 hermes peer dm <bot名> "訊息"(default 冇 api_server 只做 client) peer keys 各 profile .env(不得寫入任何文件) SOUL §四 ↔ 各 profile .env(key 輪換後 4 份同步)
C9 原文回溯(state.db 訊息原文) default — SQL 查 hermes/state.db messages 表(含已壓縮訊息) 開卡/寫文件前用 只讀,無同步檔
C10 決策守則(止蝕 2 輪/付費閘「批」字/第 0 關參考圖/Skill-First) 全部 team-workflow-rules §五§六 無(守則) — team-workflow-rules ↔ 4 份 SOUL;新類型工作先 hermes skills search 再自建
C11 說話規範(ASD-STE100 簡明技術語言原則:短句/一名一義/保留關鍵條件) 全部 team-workflow-rules §說話規範 + 各 profile SOUL(摘要節) skill simple-english(creative 類;官方 registry 裝,含規則目錄/套話對照表/自查清單) 看板 topic 1863、kanban title/summary/comment team-workflow-rules ↔ 4 份現役 SOUL(default/admin/siteops/cs);改動兩邊齊改+重跑 wiki(B1)
C12 匯報排版規範(五層 🔴/🟠/🟢/⚪/⚙️ +長度上限;詳情收埋) 全部 team-workflow-rules §匯報排版規範 + 各 profile SOUL(摘要節) [scripts]tt_report.py(helper);生產者:[scripts]site_vs_library_reconcile.py(08:30)、[scripts]kanban_daily_summary.py(08:00)、[repo]scripts/checks/check_taskcard_fields.py 看板 1863、定時任務 2868、DM 改 helper 要 4 份 SOUL+rules 同步;adapter 補丁(spoiler 加 re.DOTALL)Hermes 更新後會被覆蓋 → 更新後 grep 檢查+重啟 gateway

改動記錄

日期 工作流 改咗咩 卡
2026-09-30 A1 Insights 審核關卡 Claude→Codex(8 處:promotion-plan §2.3A+v2.5、cadence/roadmap 兩 .py、tasks*.md、log.md、live 卡 T-172) T-189
2026-09-30 — 本冊建立(三類 14 項) T-190
2026-09-30 — 收尾補正(T-190 worker 覆核):補 frontmatter+index 入冊+wikilinks;新增 6 項(B7 三頁刷新/C6 通知渠道/C7 匯報規矩/C8 Peer/C9 原文回溯/C10 決策守則)→ 共三類 20 項;cron id 全部以 jobs.json 實查回填 T-190
2026-10-04 C11 說話規範 新增 C11:說話規範(ASD-STE100 原則)落地於 team-workflow-rules §說話規範+4 份現役 SOUL 摘要節;skill simple-english 由官方 registry 安裝 T-229
2026-10-04 C12 匯報排版規範 新增 C12:五層排版(🔴/🟠/🟢/⚪/⚙️)+長度上限落地於 team-workflow-rules §匯報排版規範+4 份 SOUL;新增 [scripts]tt_report.py;改寫三個報告生產者(08:30 對帳/08:00 匯總/任務卡檢查);修 Telegram adapter spoiler regex(加 re.DOTALL) T-230