工作流登記冊(Workflow Registry)
目的:每個重要工作流列出「權威文件/執行腳本/台賬/改動同步清單」。 改任何工作流前先查本冊,跟「改動要同步」清單逐份改,唔使全檔 grep(T-189 教訓:Insights 審核由 Claude 改 Codex 要 grep 8 處先齊)。 維護:default(基礎設施管家)。每次工作流改動完成後必須回填本冊「改動記錄」。 建立:2026-09-30(T-190,Ken 拍板方案 A)。相關:team-workflow-rules、SCHEMA。
使用方式
- 收到「改工作流」指示 → 喺本冊搵對應工作流 → 睇「改動要同步」欄 → 逐份檔案改。
- 改完 → 更新「台賬」指到嘅 tasks*.md 狀態 → 喺
log.md記一筆 → 回填本冊「改動記錄」。 - 涉及 cron 腳本嘅改動 → 改完用
python -m py_compile驗證語法,確認 cron 下次跑用新邏輯。 - 涉及台賬/看板狀態 → 改完立即重跑 wiki 發布(B1),Ken 會盯手機版新鮮度。
- 涉及多份 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 |