邊界哨
Risk Gate
權限、成本、外部寫入、secrets、failure modes。
- external write / paid / vault / memory 前叫哨
- 要求 dry-run 與 approval path
hg-team call 邊界哨hg-tool dry-run
01｜分層架構
角色不是權力階級，而是風險與工作型態分層：主腦整合、器官思考、工兵執行、skills 指路、tools 觸碰世界。
主腦
hg腦魔
triage、路由、整合、回覆 Roy、守邊界。
唯一常駐 Discord bot器官
星核、機械心、像素靈、索引眼、邊界哨…
提供判斷 lens，不擁有最終決策。
advisory only工兵
researcher、maker、reviewer、Wiki/Memory packs…
短命任務，交 result，不長期掌權。
ephemeral workersSkills / Tools
OpenAB skills + hg-tool policy wrapper
skills 是 playbook；tools 是真正動世界的刀。
門禁治理02｜請求流
Roy / Discord訊息 + sender_context
hg腦魔 triage判斷成本、風險、輸出
器官 / Skills策略、工程、視覺、查證
Workers / Tools窄任務、dry-run、診斷
整合回覆結果、證據、風險、下一步
03｜判斷器官
器官是 lens，不是第二個主腦。它們幫主腦看盲點、做 tradeoff、檢查風險，但最後由 hg腦魔整合與負責。
索引眼
Evidence Route
搜尋路線、references、source strategy。
- 需要 current facts / sources
- 和 source-verification 分工：找資料 vs 驗證 claim
researchersource-verification
機械心
Engineering
CLI、工具、agent 架構、可維護性。
- 避免 brittle automation
- OpenAB / hg-tool / worker routing 診斷
agent-designerruntime-diagnostics
星核
Strategy
長期方向、roadmap、盲點與 tradeoffs。
- 目標模糊時
- 多路線選擇時
strategy / roadmap
記憶棧
Context
上下文壓縮、記憶衛生、保存候選。
- 只建議，不直接保存
- Discord thread context 走 discord-context
memory-curatordiscord-context
像素靈
Visual Taste
UI hierarchy、interaction feel、deck / prototype 視覺。
- 看起來有沒有層級與質感
- AI slop / visual polish
ui-visual-critiquerefactoring-ui
靈視監
Art Direction
視覺策略、風格一致性、creative coherence。
- moodboard / brand visual direction
- 和幻光協作 image/video direction
visual-deliveryimage-sourcing
造夢艙
Story / Deck
交付 framing、deck flow、demo narrative。
- 把材料變成說服順序
- 不負責事實研究本身
web-slideslongform-writing
幻光
Media Mood
image/video style、storyboard、motion prompt。
- 先定方向，再走 generative-media
- 生圖需遵守安全 queue / cost policy
generative-media咒語監
04｜短命工兵與 Packs
工兵拿工單，做窄任務，交付 `result.md` 或 artifact。它們不做最終決策，不碰外部世界，除非明確走工具門禁。
| 群組 | 角色 | 主要用途 | 輸出 | 邊界 |
|---|---|---|---|---|
| Generic | researcher, maker, reviewer | 研究、草稿/原型、評審 | sources、artifact、findings | 不可外部寫入；不可自稱 final authority |
| 設計 / 交付 | 原型匠、動線師、圖鑑靈、規格鬼、毒舌評審、咒語監、素材庫守 | prototype、UX flow、reference、QA、prompt pack、asset inventory | prototype、checklist、prompt、reference board | 素材權利 / 生圖成本需 gate |
| 文字 / 語氣 | 文咒師、名鑄師、聲紋守 | 文案、命名、bot voice | variants、voice guide、copy pack | 低風險 variant 可用 agy-acp；不可查證事實 |
| Wiki Pack | wiki-reader、wiki-candidate、wiki-lint | wiki 讀取、候選稿、治理 lint | answer、candidate、lint report | 不可直接寫 wiki/canonical |
| Memory Pack | memory-curator、memory-audit | 保存建議、記憶審計 | recommendations | 實際 CRUD 必須 memory-cli |
| Maintenance | hg機修 | OpenAB / hg-tool / worker routing 維修診斷 | repair plan、patch proposal | 改 config / restart 前叫邊界哨 |
05｜Mounted OpenAB Skills
Skills 是 workflow playbook，不是自動授權。新補的 skills 讓設計評審、查證、診斷、Discord context 更穩。
完整 skill 清單
agent-designerbitmap-to-vectorcode-reviewdata-visualizationdiscord-contextgenerative-mediagsap-animationgsap-reactgsap-scrolltriggerimage-sourcingknowledge-noteslongform-writingmindmap-specnewsplaywright-clirefactoring-uiruntime-diagnosticssource-verificationsvg-icon-makerui-ux-review-liteui-visual-critiquevisual-deliveryweb-slidesyt-note
綠框為這輪新增的本地化 skills。
這輪新增的五個能力
- ui-visual-critique：AI Slop Test、typography/color/spacing/motion/interaction/originality。
- source-verification：claim-level 查證，VERIFIED/REFUTED/INCONCLUSIVE。
- runtime-diagnostics：OpenAB、skills、hg-team、hg-tool、log 唯讀診斷。
- ui-ux-review-lite：5-second test、CTA clarity、critical task path。
- discord-context：sender_context、thread scope、raw transcript 邊界、memory candidates。
06｜角色 × 工具包矩陣
每個角色需要不同的 skill/tool。重點不是給所有角色所有工具，而是讓它拿到剛好足夠的刀。
角色
主要工具包 / Skills
缺口狀態
像素靈
ui-visual-critique, ui-ux-review-lite, refactoring-ui, visual-delivery, playwright-cli, GSAP skills
已補齊：可評視覺、UI hierarchy、互動感。
靈視監
visual-delivery, generative-media, image-sourcing, refactoring-ui, bitmap-to-vector
足夠：art direction / mood / coherence。
動線師
ui-ux-review-lite, playwright-cli, visual-delivery
已補 UX flow 輕量檢查。
索引眼
source-verification, researcher, news, pplx/firecrawl via hg-tool
已補 claim-source 查證牙齒。
機械心 / hg機修
runtime-diagnostics, agent-designer, code-review, hg-team doctor, hg-tool catalog
已補 runtime 診斷 playbook。
記憶棧 / 聲紋守
discord-context, memory-curator, memory-audit, memory-cli gate
已補 Discord context 與 memory candidate 邊界。
造夢艙
web-slides, visual-delivery, longform-writing, data-visualization
足夠：deck/story/prototype framing。
邊界哨
hg-tool policy, dry-run, runtime-diagnostics, source-verification for sensitive claims
可用；中期可加 approval hash 硬聯鎖。
07｜路由規則
主腦根據錯誤成本、是否要查證、是否敏感、是否要交付、是否會改世界來選路。
五級路由
| L0 Solo | 簡答、翻譯、小檢查。 |
| L1 Solo + Tools | 本地讀檔、doctor、status、grep 驗證。 |
| L2 Advisory | 策略、工程、視覺、風險判斷。 |
| L3 Workers | 研究包、prototype、prompt pack、QA checklist。 |
| L4 Boundary | 外部寫入、成本、memory/vault、服務重啟、secrets。 |
快速判斷
小事單機，深事分工；
可查先查，高風險叫哨；
要判斷叫器官，要交付派工兵；
會寫入先 dry-run，會指控先分層。
如果下一步會動外部世界，主腦必須停下：dry-run、邊界哨、明確 approval。
08｜邊界與工具治理
工具是能動世界的刀。所有外部寫入、成本、memory CRUD、vault/wiki 寫入、runtime mutation 都不應靠角色自律硬扛。
| 類型 | 門禁 | 允許條件 | 禁止事項 |
|---|---|---|---|
| 外部寫入 | hg-tool + dry-run + 邊界哨 | Roy 明確授權、wrapper 成功、必要時 HG_TOOL_ALLOW_MUTATION | 不可 shell 繞過 wrapper |
| 成本工具 | 說明成本 / scope | 小規模且政策允許，或 Roy 明確 approval | 不可默默大規模查詢/生成 |
| Vault / Wiki | vault rules + Wiki Pack | 讀取可；寫入要遵守 AGENTS.md | 不可直接寫 wiki/canonical |
| Memory | memory-curator → memory-cli | 只在 memory-cli 成功後說 saved/deleted | 不可由 worker 直接保存 |
| Runtime / Production | runtime-diagnostics → 邊界哨 → approval | 先唯讀診斷，再最小修法 | 不可擅自 restart / 改 config / 改 auth |
| Secrets | presence/scope only | 安全稽核時也不揭露值 | 不可印 token/cookie/private key |
09｜上線建議
- 這份 HTML 是單檔靜態頁，可放任何 static hosting。
- 真正 upload / publish / deploy 屬外部或 production mutation，應先 dry-run / 邊界檢查。
- 若放公開網路，避免加入內部 token、私人路徑、raw transcript。
- 建議 title：
hg腦魔 Agent Role System。
10｜下一步
若要把這份頁面正式上線，下一步不是再改角色，而是選 hosting route：
- 本地預覽：直接打開 HTML。
- 內部分享：丟到 Drive / static file server。
- 公開部署：走 GitHub Pages / Vercel / Netlify / 自有 server。
發布時叫邊界哨，腦魔不偷偷把門打開。魔界也要門禁。