Zurück zu Fähigkeiten

adapt-architecture

pjt222
Aktualisiert 6 days ago
11 Ansichten
17
2
17
Auf GitHub ansehen
Designdesign

Über

Diese Fähigkeit bietet eine strukturierte Methode zur schrittweisen Weiterentwicklung der Systemarchitektur unter Verwendung von Mustern wie dem Würgefeigen-Prinzip. Sie ermöglicht inkrementelle Migration, parallelen Betrieb und sichere Rollbacks, um Risiken bei tiefgreifenden Änderungen – wie dem Wechsel von einer Monolith- zu einer Microservices-Architektur – zu minimieren. Nutzen Sie sie, wenn Sie eine kontrollierte, schrittweise Transformation anstelle eines riskanten "Big-Bang"-Austauschs benötigen.

Schnellinstallation

Claude Code

Empfohlen
Primär
npx skills add pjt222/agent-almanac -a claude-code
Plugin-BefehlAlternativ
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternativ
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/adapt-architecture

Kopieren Sie diesen Befehl und fügen Sie ihn in Claude Code ein, um diese Fähigkeit zu installieren

Dokumentation

變構

形變不輟運也。絞榕、蛹、護介為法。

  • assess-form 判 READY→用
  • 須變構而不停→用
  • 整→微服或反→用
  • 換核而依者續行→用
  • 數模演而存後容→用
  • 凡變宜漸非驟→用

  • :今形評(自 assess-form
  • :標構
  • :運續之要(不可斷者)
  • :變預(時、人、算)
  • :退求(退至何處)
  • :並行之久

一:謀

繪自今至標之路。

  1. 列中間諸形:今→中一→…→標
    • 各中形必可運(受流、過驗)
    • 中形不得難於今
  2. 識縫:何處可剖以入新
    • 自然縫:介、模界、數分
    • 人工縫:為剖而設之介(防腐層)
  3. 擇變式:
    • 絞榕:新繞舊漸代
    • :包舊以新殼,內換而殼存外介
    • :新與舊並,流漸移(見 scale-colony
    • 遞變:依序代之(葉先根後)
  4. 設護介層:
    • 外用者不擾
    • API 版、後容、配器
    • 護介乃暫——預其去
Metamorphosis Patterns:
┌───────────────┬───────────────────────────────────────────────────┐
│ Strangler Fig │ New code intercepts routes one by one;            │
│               │ old code handles everything else until replaced   │
│               │ ┌──────────┐                                     │
│               │ │ Old ████ │ → │ Old ██ New ██ │ → │ New ████ │  │
│               │ └──────────┘                                     │
├───────────────┼───────────────────────────────────────────────────┤
│ Chrysalis     │ Wrap old system in new interface; replace         │
│               │ internals while external shell stays stable       │
│               │ ┌──────────┐     ┌──[new]───┐     ┌──[new]───┐  │
│               │ │ old core │ → │ old core │ → │ new core │  │
│               │ └──────────┘     └──────────┘     └──────────┘  │
├───────────────┼───────────────────────────────────────────────────┤
│ Budding       │ New system runs in parallel; traffic shifts       │
│               │ ┌──────┐ ┌──────┐     ┌──────┐ ┌──────┐         │
│               │ │ Old  │ │ New  │  →  │ Old  │ │ New  │         │
│               │ │ 100% │ │  0%  │     │  0%  │ │ 100% │         │
│               │ └──────┘ └──────┘     └──────┘ └──────┘         │
└───────────────┴───────────────────────────────────────────────────┘

得:藍圖明中形、縫、式、護介,步皆具體可驗。

敗:無縫→先 dissolve-form 以造縫。中形不可運→步太大,析之為小增。

二:搭架

築變所賴之暫構。

  1. 造防腐層:
    • 新舊間之薄譯層
    • 按遷態路請求至應者
    • 譯舊新之數式
    • 此層即護蛹
  2. 設並行:
    • 新舊可同部
    • 旗控何流入何
    • 比機驗新舊果同
  3. 立退點:
    • 各中形驗可退前
    • 退須速於進
    • 數遷可逆,或過渡時雙寫
  4. 建驗夾:
    • 自動驗各中形運續
    • 性能基準察退化
    • 數整驗捕遷誤

得:防腐層、並行、退、驗皆備而後變起。架本身已驗。

敗:架太貴→簡之:最小架=旗+退法。防腐與並行加安但小變不必。

三:漸換

逐部自舊遷新。

  1. 排部之序:
    • 始自最鬆最輕者(建信)
    • 進至要而緊者
    • 最緊要者末(時隊已熟)
  2. 各部: a. 新版於防腐層後 b. 並行:新舊同入 c. 比果——應同(異則預期且記) d. 信則翻旗移流 e. 監異(換後加感) f. 穩期後撤舊
  3. 全程持續交付:
    • 各換為常部,非特事
    • 系恆於知、驗、運態
    • 換致誤→退前態(仍可運)

得:功逐部遷,各步皆驗。系恆運。各換育次信。

敗:並行見異→新有蟲,先修。換致退化→新部宜優或防腐層過重。隊失信→停而穩,半遷之系勝倉促全遷。

四:理蛹

度最脆之期——形之間。

  1. 認蛹實:
    • 遷時系半舊半新
    • 此雜態本繁於純態
    • 繁峰於遷之中,後減
  2. 蛹律:
    • 蛹期無新功(唯變)
    • 外變最少(凍非要部)
    • 加監加值
    • 日察進與健
  3. 中蛹評:
    • 半時評:標仍對乎
    • 市、需、隊有變影標乎
    • 續、停、改向
  4. 護蛹:
    • 退路恆通
    • 厚記今雜態(後人除錯需)
    • 抗除暫架之誘——遷未畢

得:蛹期為自覺、限時之期,律加監加。隊知暫繁乃安變之代。

敗:蛹拖久→雜態為新常,劣於兩端。設限。至限則速畢餘遷或受雜為新形而穩。

五:畢變而穩

成變、撤架。

  1. 末換:
    • 末部遷新
    • 全驗套行新系
    • 性能驗於擬產之載
  2. 撤架:
    • 撤防腐層(無需矣)
    • 去遷之旗
    • 清並行設
    • 存(勿刪)舊碼以參
  3. 後變穩:
    • 新形運 2-4 週加監
    • 解實況下新症
    • 更文以反新構
  4. 回顧:
    • 何處善
    • 何處難於預
    • 下次何改
    • 更隊變譜

得:變畢。系於新形運。架已撤。文已更。隊得學以備後變。

敗:換後新形不穩→存退路續穩。穩過期→新構恐有設誤,考定修或部退最劣者。

  • 藍圖示中形可運
  • 架(防腐、退、驗夾)於遷起前已備
  • 部按低至高險之序遷
  • 並行各步驗同
  • 蛹期限時且凍新功
  • 變畢架皆撤
  • 後變穩期無大症
  • 回顧得學

  • 驟遷:欲一舉變盡。棄漸換之安,最大爆域。必漸遷
  • 架不撤:防腐層、旗久存→技債。撤架預入變謀,非後想
  • 否蛹:偽稱雜為常→於不穩築新功。認蛹期、行其律
  • 執標:執新構而忽更佳之兆。中蛹評即為此
  • 變疲:久遷耗隊。步小至日畢,非週。記里程以續勢

  • assess-form — 前置評:判系可變否
  • dissolve-form — 系剛不可直變者:溶之以造縫
  • repair-damage — 變致損之復技
  • shift-camouflage — 表變或足無須深構變
  • coordinate-swarm — 群協告分散系變之序
  • scale-colony — 長壓常為構變之發
  • implement-gitops-workflow — GitOps 為漸換之部設
  • review-software-architecture — 評標構之伴技

GitHub Repository

pjt222/agent-almanac
Pfad: i18n/wenyan-ultra/skills/adapt-architecture
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Verwandte Skills

executing-plans

Design

Verwenden Sie die Fähigkeit "executing-plans", wenn Sie einen vollständigen Implementierungsplan zur Ausführung in kontrollierten Batches mit Überprüfungspunkten vorliegen haben. Sie lädt den Plan und überprüft ihn kritisch, führt dann Aufgaben in kleinen Batches (standardmäßig 3 Aufgaben) aus und meldet den Fortschritt zwischen jedem Batch zur Überprüfung durch den Architekten. Dies gewährleistet eine systematische Implementierung mit integrierten Qualitätskontrollpunkten.

Skill ansehen

requesting-code-review

Design

Diese Fähigkeit sendet einen Unteragenten für Code-Review, um Codeänderungen anhand der Anforderungen zu analysieren, bevor fortgefahren wird. Sie sollte nach dem Abschließen von Aufgaben, der Implementierung größerer Funktionen oder vor dem Zusammenführen in den Hauptzweig verwendet werden. Die Überprüfung hilft dabei, Probleme frühzeitig zu erkennen, indem die aktuelle Implementierung mit dem ursprünglichen Plan verglichen wird.

Skill ansehen

connect-mcp-server

Design

Diese Fähigkeit bietet Entwicklern eine umfassende Anleitung, um MCP-Server über HTTP-, stdio- oder SSE-Transports mit Claude Code zu verbinden. Sie behandelt Installation, Konfiguration, Authentifizierung und Sicherheit für die Integration externer Dienste wie GitHub, Notion und benutzerdefinierter APIs. Nutzen Sie sie beim Einrichten von MCP-Integrationen, bei der Konfiguration externer Tools oder bei der Arbeit mit Claude's Model Context Protocol.

Skill ansehen

web-cli-teleport

Design

Diese Fähigkeit unterstützt Entwickler bei der Wahl zwischen Claude Code Web- und CLI-Schnittstellen basierend auf Aufgabenanalysen und ermöglicht nahtloses Session-Teleporting zwischen diesen Umgebungen. Sie optimiert den Workflow, indem sie den Sitzungsstatus und Kontext beim Wechsel zwischen Web, CLI oder Mobilgeräten verwaltet. Nutzen Sie sie für komplexe Projekte, die in verschiedenen Phasen unterschiedliche Werkzeuge erfordern.

Skill ansehen