在构建基于 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。