返回技能列表

adapt-architecture

pjt222
更新于 6 days ago
17 次查看
17
2
17
在 GitHub 上查看
设计design

关于

This skill provides a structured method for gradually evolving system architecture using patterns like the strangler fig. It enables incremental migration, parallel running, and safe rollback, minimizing risk during major changes like moving from a monolith to microservices. Use it when you need a controlled, phased transformation instead of a risky "big-bang" replacement.

快速安装

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/adapt-architecture

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

技能文档

變構

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

  • 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 仓库

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

相关推荐技能

executing-plans

设计

该Skill用于当开发者提供完整实施计划时,以受控批次方式执行代码实现。它会先审阅计划并提出疑问,然后分批次执行任务(默认每批3个任务),并在批次间暂停等待审查。关键特性包括分批次执行、内置检查点和架构师审查机制,确保复杂系统实现的可控性。

查看技能

requesting-code-review

设计

该Skill可在完成任务、实现主要功能或合并代码前自动调度代码审查子代理,确保实现符合需求和计划。它支持通过指定git SHA范围进行精准的代码变更审查,帮助开发者在关键节点及时发现潜在问题。核心原则是"早审查、勤审查",适用于开发流程的各个关键阶段。

查看技能

connect-mcp-server

设计

这个Skill指导开发者如何将MCP服务器连接到Claude Code,支持HTTP、stdio和SSE三种传输协议。它涵盖了从安装配置到认证安全的完整流程,适用于集成GitHub、Notion、数据库等外部服务。当开发者需要添加集成、配置外部工具或提及MCP相关功能时,这个Skill能提供实用的操作指南。

查看技能

web-cli-teleport

设计

该Skill帮助开发者根据任务特性选择Claude Code的Web或CLI界面,并指导如何在两种环境间无缝迁移会话。它能分析任务复杂度、迭代需求等要素,推荐最优工作界面和工作流。关键特性包括会话状态管理、环境切换指导和上下文优化建议。

查看技能