返回技能列表

scale-colony

pjt222
更新于 5 days ago
11 次查看
17
2
17
在 GitHub 上查看
文档ai

关于

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.

快速安装

Claude Code

推荐
主要方式
npx skills add pjt222/agent-almanac -a claude-code
插件命令备选方式
/plugin add https://github.com/pjt222/agent-almanac
Git 克隆备选方式
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/scale-colony

在 Claude Code 中复制并粘贴此命令以安装该技能

技能文档

擴展群落

以群落分巢(分裂)、角色分化(年齡多態)與增長觸發之架構轉換來擴展分散式系統、團隊或組織——於群落超出其初始設計容量增長之時,維持協調品質。

適用時機

  • 一支於 10 個體運作之團隊或系統於 50 個體時崩解
  • 通訊開銷增長快於產出
  • 隱性之協調模式須化為顯性
  • 規劃增長階段並欲主動而非被動擴展
  • 觀察到與規模相關之協調失敗(訊息遺失、工作重複、所有權不明)
  • 既有系統須分裂為半自治之子群落

輸入

  • 必要:當前群落規模與目標增長(或增長率)
  • 必要:當前協調機制及其壓力點
  • 選擇性:群落結構(扁平、階層、聚集)
  • 選擇性:已就位之角色分化
  • 選擇性:增長時間表與限制
  • 選擇性:群落間協調需求(若分裂)

步驟

步驟一:辨識增長階段

識別群落所處之擴展階段,以套用適當策略。

  1. 分類當前增長階段:
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     │
└───────────┴──────────────┴───────────────────────────────────────────┘
  1. 識別增長壓力訊號:
    • 通訊過載:每個體每日訊息數增長快於群落規模
    • 決策延遲:自提案至決策之時間增加
    • 協調失敗:工作重複、任務漏失、衝突動作增加
    • 知識稀釋:新個體需更久才能產出
    • 身份遺失:個體無法一致地描述群落之目的
  2. 判斷群落是否將跨或已跨階段邊界

預期: 對當前增長階段及表明群落正接近或已跨階段邊界之具體壓力訊號之清晰識別。

失敗時: 若階段不明,量測三具體指標:每個體之通訊量、決策延遲與協調失敗率。將其隨時間繪圖。轉折點揭露階段轉換。若無指標可用,群落可能於建立階段(其時尚不需指標)。

步驟二:實作角色分化(年齡多態)

引入漸進專業化,使個體依經驗與群落需求承擔不同角色。

  1. 定義角色進階路徑:
    • 新手:觀察、學習、簡單任務(低自主、高指引)
    • 工人:標準任務執行、跟隨訊號(中度自主)
    • 專家:領域專業、複雜任務、指導新手(高自主)
    • 採食者/偵察者:探索、創新、外部介面(見 forage-resources
    • 協調者:群落間通訊、衝突解決、法定人數管理
  2. 實作角色轉換:
    • 轉換由經驗閾值觸發,非任命
    • 已成功完成閾值任務數之個體轉至下一角色(依任務複雜度與群落增長率校準閾值——如簡單角色 5-10 任務、專家角色 20-30)
    • 反向轉換可能(專家於新領域回工人角色)
    • 群落角色分佈適應當前需求:
      • 增長中之群落 → 更多新手缺、活躍之指導
      • 穩定群落 → 各角色平衡分佈
      • 受脅群落 → 更多防禦者、更少偵察者(見 defend-colony
  3. 保留角色靈活性:
    • 無個體永久鎖於某角色
    • 緊急協議可暫時將任意個體重派至任意角色
    • 跨訓練確保個體可覆蓋鄰近角色

預期: 角色結構使個體自然由簡單向複雜責任進階,群落角色分佈反映其當前需求與階段。

失敗時: 若角色分化造成僵化孤島,提高跨訓練要求與輪換頻率。若新手難進階,指導系統不足——將每新手與專家配對其前 N 任務。若太多個體聚於一角色,轉換觸發校準錯誤——依群落整體角色需求調整閾值。

步驟三:為規模重構協調

調整 coordinate-swarm 之協調機制以處理增大之群落規模。

  1. 以分層訊號取代直接通訊:
    • 建立階段:人人對人人(N×N 通訊)
    • 增長階段:聚為 5-8 之小組;組內直接通訊、組間訊號式
    • 成熟階段:組成部門;組內直接、組間訊號、部門間廣播
  2. 實作協調層:
    • 本地協調:組內,直接訊號交換(共識覓徑)
    • 區域協調:同部門組間,匯總訊號
    • 群落協調:部門間,廣播訊號僅用於群落層決策
  3. 設計層間介面:
    • 每組有一指定通訊者匯總並轉發訊號
    • 通訊者過濾噪音:非每本地訊號皆向上轉發
    • 群落層廣播罕用,保留予法定人數決策、警報升級或重大狀態變化
  4. 通訊開銷預算:
    • 目標:每個體用於協調之容量 <20%
    • 量測實際開銷;若超預算,加另一協調層或拆過大之組

預期: 分層協調結構使通訊開銷隨群落規模對數(非線性)增長。本地協調快速直接;群落層協調較慢但仍可運作。

失敗時: 若協調層產生資訊瓶頸(通訊者過載),加冗餘通訊者或降低轉發頻率。若各層產生隔離(組不知他組做什麼),提高層間訊號頻率或建跨組聯絡角色。

步驟四:執行群落分巢(分裂)

當群落超出單一協調容量時,分裂為半自治子群落。

  1. 辨識分裂觸發:
    • 群落超 100 個體(或協調層數超 3)
    • 即便分層,通訊開銷仍超個體容量 30%
    • 對時間敏感操作,決策延遲超可接受閾值
    • 子群已發展出獨立身份且可獨立運作
  2. 規劃分裂:
    • 識別自然分裂線(既有聚集、領域邊界、地理分隔)
    • 確保每子群落有可行之角色分佈(不可將所有專家分入一群落)
    • 每子群落須有:至少一協調者、足量工人、共享資源之存取
    • 定義群落間介面:何資訊共享、何獨立
  3. 執行分裂:
    • 公告分裂計劃與時程(需共識——見 build-consensus
    • 依既有聚集成員身份將個體轉至子群落
    • 建立群落間通訊通道(輕量、非同步)
    • 每子群落啟動其本地協調(繼承自親之模式)
  4. 分裂後穩定:
    • 監控每子群落之存活力(其能否自立?)
    • 群落間協調應極少(季度同步,非每日)
    • 若子群落失敗,將其重併入最近之可行群落

預期: 兩個或更多可行之子群落,各以自有協調半自治運作,以輕量群落間介面相連。

失敗時: 若子群落過小不可行,分裂過早——重併並於更大規模再試。若群落間協調變得如分裂前單群落般沈重,分裂線錯誤——群落間過於相依。沿自然獨立線重劃邊界。

步驟五:監控擴展極限並適應

持續評估當前結構是否符合群落規模與需求。

  1. 追蹤擴展健康指標:
    • 協調開銷比:協調時間/生產時間
    • 決策吞吐:每時間單位之決策(增長時應上升或穩定)
    • 個體滿意度:投入度、留任、目的感(擴展失敗時下降)
    • 錯誤率:每時間單位之協調失敗(不應隨增長線性上升)
  2. 識別擴展極限指標:
    • 開銷比超 25% → 需更多自動化或另一協調層
    • 決策吞吐下降 → 治理結構需修訂
    • 個體流失率上升 → 擴展之文化或結構問題
    • 錯誤率加速 → 協調機制正失效
  3. 觸發適應:
    • 偵測階段轉換 → 套用步驟一之適當階段策略
    • 達擴展極限 → 升級至下一結構介入(角色分化 → 協調重構 → 分裂)
    • 外部變化(市場轉變、技術破壞) → 可能需群落轉化(見 adapt-architecture

預期: 群落自監其擴展健康並於擴展壓力成擴展失敗前主動適應其結構。

失敗時: 若無擴展健康指標可用,群落缺可觀察性——建構量測在建構更多結構之前。若指標顯示問題而群落無法適應,阻力為文化非技術——重構前處理人因(變化恐懼、所有權執著、信任赤字)。

驗證

  • 當前增長階段已識別,附具體壓力訊號
  • 角色分化已定義,含漸進專業化
  • 協調已適切群落規模分層
  • 通訊開銷維持於個體容量 20-25% 以下
  • 群落超單一協調容量時之分裂計劃已存
  • 擴展健康指標已追蹤,閾值觸發適應
  • 每子群落(分裂後)有可行角色分佈

常見陷阱

  • 未需即擴展結構:過早分層加開銷而無益。10 人團隊不需部門協調者。應由壓力訊號引導結構變化
  • 不計代價保留建立期文化:5 個體所行不適 50 個體。擴展需結構演化;對建立階段之懷舊阻礙必要適應
  • 無獨立性之分裂:將群落分為仍每日相互依賴之子群落產生兩面之惡——協調開銷加分隔開銷
  • 均一角色分佈:非每子群落需相同角色比。研究群落需更多偵察者;生產群落需更多工人。應依使命適應角色分佈
  • 忽視重併為選項:有時分裂失敗,最佳之舉是重併。將分裂視為不可逆阻礙從壞分裂中復原

相關技能

  • coordinate-swarm — 此技能所擴展之基礎協調模式
  • forage-resources — 採食擴展不同於生產;角色分化影響偵察者分配
  • build-consensus — 共識機制須為大型群組適應
  • defend-colony — 防禦須隨群落擴展
  • adapt-architecture — 結構轉化之 morphic 技能,由增長壓力觸發
  • plan-capacity — 增長預測之容量規劃
  • conduct-retrospective — 回顧協助於擴展壓力成失敗前識別之

GitHub 仓库

pjt222/agent-almanac
路径: i18n/wenyan-lite/skills/scale-colony
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

相关推荐技能

railway-docs

文档

Railway Docs Skill可实时获取最新的Railway官方文档,确保回答的准确性。当开发者询问Railway功能特性、工作原理或分享docs.railway.com链接时,应优先使用此技能。它通过专门的LLM优化文档源提供最新信息,避免依赖过时记忆来回答技术问题。

查看技能

n8n-code-python

文档

该Skill为在n8n平台的Python代码节点中编写代码提供专家指导,特别适用于需要使用_input/_json/_node语法、Python标准库或了解n8n中Python限制的场景。它强调JavaScript应作为首选方案,仅当需要特定Python功能或对Python语法更熟悉时才使用Python。Skill提供了快速入门模板和关键注意事项,帮助开发者在n8n中高效编写Python代码。

查看技能

archon

文档

Archon Skill为开发者提供了基于RAG的语义搜索和项目任务管理功能,可通过REST API访问知识库。它支持文档搜索、网站爬取、文件上传和版本控制,适用于技术文档查询和项目管理场景。首次使用时需要配置Archon主机地址,建议在处理外部文档时优先使用该Skill。

查看技能

n8n-code-javascript

文档

这个Skill为n8n工作流中的JavaScript代码节点提供专业指导,涵盖数据处理、HTTP请求和日期操作等核心场景。它详细解释了如何正确使用n8n特有的`$input`/`$json`语法、`$helpers`工具以及DateTime对象,并包含关键的错误排查和模式选择建议。开发者通过该Skill能快速掌握Code节点的正确返回格式、数据访问方法和常见陷阱解决方案。

查看技能