在構建基於 DeepSeek Harness (DSH) 的智能體時,開發者常面臨 AWS Cloud Development Kit (CDK) 代碼缺乏最佳實踐指導、安全合規性檢查繁瑣以及快速查找架構模式困難的問題。xby-awslabs-cdk 插件通過提供 CDK Nag 規則解釋、架構模式檢索等功能,輔助開發者構建合規且高效的 AWS 基礎設施。
這是什麼¶
該插件由 xby-skill 維護,屬於“聯網工具”類別。它作爲一個 AWS CDK MCP Server,旨在爲開發者提供 CDK 最佳實踐、基礎設施即代碼模式以及 CDK Nag 安全合規性檢查服務。
核心功能¶
插件提供以下主要功能:
- set_xby_apikey:在聊天中設置 API 密鑰,自動持久化,重啓有效。
- CDKGeneralGuidance:獲取構建 AWS 應用程序的規範性 CDK 建議。
- ExplainCDKNagRule:解釋特定的 CDK Nag 規則,提供 AWS Well-Architected 指導和修復步驟。
- CheckCDKNagSuppressions:檢查 CDK 代碼中的 Nag 抑制項,確保安全抑制項經過人工審查(已棄用,建議使用 AWS IaC MCP Server)。
- GenerateBedrockAgentSchema:從文件生成 Bedrock Agent Action Groups 的 OpenAPI Schema(已棄用,建議使用 AWS IaC MCP Server)。
- GetAwsSolutionsConstructPattern:搜索和發現 AWS 解決方案構造模式。
- SearchGenAICDKConstructs:搜索和發現 GenAI CDK 構造。
- LambdaLayerDocumentationProvider:提供 Lambda 層文檔來源。
安裝與啓用¶
使用以下命令安裝插件:
dsh plugin --profile web add github:xby_skill/xby-awslabs-cdk
該插件的許可證爲 MIT。
典型用法¶
1. 設置 API 密鑰¶
在對話中設置 API 密鑰,該密鑰會自動持久化,重啓 DSH 後依然有效。
2. 解釋 CDK Nag 規則¶
當遇到特定的 CDK Nag 錯誤(例如 AwsSolutions-IAM4)時,可以直接詢問插件獲取解釋和修復步驟。
import { App } from 'aws-cdk-lib';
import { AwsSolutionsChecks } from 'cdk-nag';
const app = new App();
const stack = new MyStack(app, 'MyStack');
AwsSolutionsChecks.check(app);
3. 搜索解決方案模式¶
搜索 AWS 解決方案構造模式,以快速實現常見架構(例如 API + Lambda + DynamoDB)。
4. 提供 Lambda 層文檔¶
在開發 Lambda 層時,請求文檔來源信息以輔助集成。
適用場景與注意¶
- 前置條件:使用該插件需要 API 密鑰,需前往 小笨羊官網 註冊獲取。
- 版本信息:目前版本爲 1.0.0。
- 功能狀態:部分工具(
CheckCDKNagSuppressions和GenerateBedrockAgentSchema)已標記爲棄用,請關注 AWS IaC MCP Server 的替代方案。 - 運行權限:插件以當前 DSH 進程的權限運行,安裝前建議檢查源碼與許可證。
結尾¶
該插件通過集成 CDK 最佳實踐和安全檢查,降低了編寫複雜 AWS 基礎設施代碼的門檻。開發者可以通過以下鏈接訪問插件詳情:目錄頁 和 GitHub。