scale-colony
About
This skill provides patterns for scaling distributed systems and organizations by mimicking biological colonies, using techniques like budding, role specialization, and architectural transitions triggered by growth. It helps when systems that worked at a small scale (e.g., 10 agents) break down at larger sizes (e.g., 50), communication overhead explodes, or coordination failures like duplicated work occur. Key capabilities include growth phase recognition, fission protocols, and scaling limit detection.
Quick Install
Claude Code
Recommendednpx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/scale-colonyCopy and paste this command in Claude Code to install this skill
Documentation
擴展群落
以群落分巢(分裂)、角色分化(年齡多態)與增長觸發之架構轉換來擴展分散式系統、團隊或組織——於群落超出其初始設計容量增長之時,維持協調品質。
適用時機
- 一支於 10 個體運作之團隊或系統於 50 個體時崩解
- 通訊開銷增長快於產出
- 隱性之協調模式須化為顯性
- 規劃增長階段並欲主動而非被動擴展
- 觀察到與規模相關之協調失敗(訊息遺失、工作重複、所有權不明)
- 既有系統須分裂為半自治之子群落
輸入
- 必要:當前群落規模與目標增長(或增長率)
- 必要:當前協調機制及其壓力點
- 選擇性:群落結構(扁平、階層、聚集)
- 選擇性:已就位之角色分化
- 選擇性:增長時間表與限制
- 選擇性:群落間協調需求(若分裂)
步驟
步驟一:辨識增長階段
識別群落所處之擴展階段,以套用適當策略。
- 分類當前增長階段:
Colony Growth Phases:
┌───────────┬──────────────┬───────────────────────────────────────────┐
│ Phase │ Size Range │ Characteristics │
├───────────┼──────────────┼───────────────────────────────────────────┤
│ Founding │ 1-7 agents │ Everyone does everything, direct comms, │
│ │ │ implicit coordination, high agility │
├───────────┼──────────────┼───────────────────────────────────────────┤
│ Growth │ 8-30 agents │ Roles emerge, some specialization, comms │
│ │ │ overhead increases, need for structure │
├───────────┼──────────────┼───────────────────────────────────────────┤
│ Maturity │ 30-100 agents│ Formal roles, layered coordination, │
│ │ │ sub-groups form, inter-group coordination │
├───────────┼──────────────┼───────────────────────────────────────────┤
│ Fission │ 100+ agents │ Colony too large for single coordination │
│ │ │ framework, must bud into sub-colonies │
└───────────┴──────────────┴───────────────────────────────────────────┘
- 識別增長壓力訊號:
- 通訊過載:每個體每日訊息數增長快於群落規模
- 決策延遲:自提案至決策之時間增加
- 協調失敗:工作重複、任務漏失、衝突動作增加
- 知識稀釋:新個體需更久才能產出
- 身份遺失:個體無法一致地描述群落之目的
- 判斷群落是否將跨或已跨階段邊界
預期: 對當前增長階段及表明群落正接近或已跨階段邊界之具體壓力訊號之清晰識別。
失敗時: 若階段不明,量測三具體指標:每個體之通訊量、決策延遲與協調失敗率。將其隨時間繪圖。轉折點揭露階段轉換。若無指標可用,群落可能於建立階段(其時尚不需指標)。
步驟二:實作角色分化(年齡多態)
引入漸進專業化,使個體依經驗與群落需求承擔不同角色。
- 定義角色進階路徑:
- 新手:觀察、學習、簡單任務(低自主、高指引)
- 工人:標準任務執行、跟隨訊號(中度自主)
- 專家:領域專業、複雜任務、指導新手(高自主)
- 採食者/偵察者:探索、創新、外部介面(見
forage-resources) - 協調者:群落間通訊、衝突解決、法定人數管理
- 實作角色轉換:
- 轉換由經驗閾值觸發,非任命
- 已成功完成閾值任務數之個體轉至下一角色(依任務複雜度與群落增長率校準閾值——如簡單角色 5-10 任務、專家角色 20-30)
- 反向轉換可能(專家於新領域回工人角色)
- 群落角色分佈適應當前需求:
- 增長中之群落 → 更多新手缺、活躍之指導
- 穩定群落 → 各角色平衡分佈
- 受脅群落 → 更多防禦者、更少偵察者(見
defend-colony)
- 保留角色靈活性:
- 無個體永久鎖於某角色
- 緊急協議可暫時將任意個體重派至任意角色
- 跨訓練確保個體可覆蓋鄰近角色
預期: 角色結構使個體自然由簡單向複雜責任進階,群落角色分佈反映其當前需求與階段。
失敗時: 若角色分化造成僵化孤島,提高跨訓練要求與輪換頻率。若新手難進階,指導系統不足——將每新手與專家配對其前 N 任務。若太多個體聚於一角色,轉換觸發校準錯誤——依群落整體角色需求調整閾值。
步驟三:為規模重構協調
調整 coordinate-swarm 之協調機制以處理增大之群落規模。
- 以分層訊號取代直接通訊:
- 建立階段:人人對人人(N×N 通訊)
- 增長階段:聚為 5-8 之小組;組內直接通訊、組間訊號式
- 成熟階段:組成部門;組內直接、組間訊號、部門間廣播
- 實作協調層:
- 本地協調:組內,直接訊號交換(共識覓徑)
- 區域協調:同部門組間,匯總訊號
- 群落協調:部門間,廣播訊號僅用於群落層決策
- 設計層間介面:
- 每組有一指定通訊者匯總並轉發訊號
- 通訊者過濾噪音:非每本地訊號皆向上轉發
- 群落層廣播罕用,保留予法定人數決策、警報升級或重大狀態變化
- 通訊開銷預算:
- 目標:每個體用於協調之容量 <20%
- 量測實際開銷;若超預算,加另一協調層或拆過大之組
預期: 分層協調結構使通訊開銷隨群落規模對數(非線性)增長。本地協調快速直接;群落層協調較慢但仍可運作。
失敗時: 若協調層產生資訊瓶頸(通訊者過載),加冗餘通訊者或降低轉發頻率。若各層產生隔離(組不知他組做什麼),提高層間訊號頻率或建跨組聯絡角色。
步驟四:執行群落分巢(分裂)
當群落超出單一協調容量時,分裂為半自治子群落。
- 辨識分裂觸發:
- 群落超 100 個體(或協調層數超 3)
- 即便分層,通訊開銷仍超個體容量 30%
- 對時間敏感操作,決策延遲超可接受閾值
- 子群已發展出獨立身份且可獨立運作
- 規劃分裂:
- 識別自然分裂線(既有聚集、領域邊界、地理分隔)
- 確保每子群落有可行之角色分佈(不可將所有專家分入一群落)
- 每子群落須有:至少一協調者、足量工人、共享資源之存取
- 定義群落間介面:何資訊共享、何獨立
- 執行分裂:
- 公告分裂計劃與時程(需共識——見
build-consensus) - 依既有聚集成員身份將個體轉至子群落
- 建立群落間通訊通道(輕量、非同步)
- 每子群落啟動其本地協調(繼承自親之模式)
- 公告分裂計劃與時程(需共識——見
- 分裂後穩定:
- 監控每子群落之存活力(其能否自立?)
- 群落間協調應極少(季度同步,非每日)
- 若子群落失敗,將其重併入最近之可行群落
預期: 兩個或更多可行之子群落,各以自有協調半自治運作,以輕量群落間介面相連。
失敗時: 若子群落過小不可行,分裂過早——重併並於更大規模再試。若群落間協調變得如分裂前單群落般沈重,分裂線錯誤——群落間過於相依。沿自然獨立線重劃邊界。
步驟五:監控擴展極限並適應
持續評估當前結構是否符合群落規模與需求。
- 追蹤擴展健康指標:
- 協調開銷比:協調時間/生產時間
- 決策吞吐:每時間單位之決策(增長時應上升或穩定)
- 個體滿意度:投入度、留任、目的感(擴展失敗時下降)
- 錯誤率:每時間單位之協調失敗(不應隨增長線性上升)
- 識別擴展極限指標:
- 開銷比超 25% → 需更多自動化或另一協調層
- 決策吞吐下降 → 治理結構需修訂
- 個體流失率上升 → 擴展之文化或結構問題
- 錯誤率加速 → 協調機制正失效
- 觸發適應:
- 偵測階段轉換 → 套用步驟一之適當階段策略
- 達擴展極限 → 升級至下一結構介入(角色分化 → 協調重構 → 分裂)
- 外部變化(市場轉變、技術破壞) → 可能需群落轉化(見
adapt-architecture)
預期: 群落自監其擴展健康並於擴展壓力成擴展失敗前主動適應其結構。
失敗時: 若無擴展健康指標可用,群落缺可觀察性——建構量測在建構更多結構之前。若指標顯示問題而群落無法適應,阻力為文化非技術——重構前處理人因(變化恐懼、所有權執著、信任赤字)。
驗證
- 當前增長階段已識別,附具體壓力訊號
- 角色分化已定義,含漸進專業化
- 協調已適切群落規模分層
- 通訊開銷維持於個體容量 20-25% 以下
- 群落超單一協調容量時之分裂計劃已存
- 擴展健康指標已追蹤,閾值觸發適應
- 每子群落(分裂後)有可行角色分佈
常見陷阱
- 未需即擴展結構:過早分層加開銷而無益。10 人團隊不需部門協調者。應由壓力訊號引導結構變化
- 不計代價保留建立期文化:5 個體所行不適 50 個體。擴展需結構演化;對建立階段之懷舊阻礙必要適應
- 無獨立性之分裂:將群落分為仍每日相互依賴之子群落產生兩面之惡——協調開銷加分隔開銷
- 均一角色分佈:非每子群落需相同角色比。研究群落需更多偵察者;生產群落需更多工人。應依使命適應角色分佈
- 忽視重併為選項:有時分裂失敗,最佳之舉是重併。將分裂視為不可逆阻礙從壞分裂中復原
相關技能
coordinate-swarm— 此技能所擴展之基礎協調模式forage-resources— 採食擴展不同於生產;角色分化影響偵察者分配build-consensus— 共識機制須為大型群組適應defend-colony— 防禦須隨群落擴展adapt-architecture— 結構轉化之 morphic 技能,由增長壓力觸發plan-capacity— 增長預測之容量規劃conduct-retrospective— 回顧協助於擴展壓力成失敗前識別之
GitHub Repository
Related Skills
railway-docs
DocumentationThis skill fetches current Railway documentation to answer questions about features, functionality, or specific docs URLs. It ensures developers receive accurate, up-to-date information directly from Railway's official sources. Use it when users ask how Railway works or reference Railway documentation.
n8n-code-python
DocumentationThis Claude Skill provides expert guidance for writing Python code in n8n's Code nodes, specifically for using Python's standard library and working with n8n's special syntax like `_input`, `_json`, and `_node`. It helps developers understand Python's limitations within n8n and recommends using JavaScript for most workflows while offering Python solutions for specific data transformation needs.
archon
DocumentationThe Archon skill provides RAG-powered semantic search and project management through a REST API. Use it for querying documentation, managing hierarchical projects/tasks, and performing knowledge retrieval with document upload capabilities. Always prioritize Archon first when searching external documentation before using other sources.
n8n-code-javascript
DocumentationThis Claude Skill provides expert guidance for writing JavaScript code in n8n's Code nodes. It covers essential n8n-specific syntax like `$input`/`$json` variables, HTTP helpers, and DateTime handling, while troubleshooting common errors. Use it when developing n8n workflows that require custom JavaScript processing in Code nodes.
