security

安全 skill 概览

security skill 的作用

security skill 会使用带有 AWS security stencil 的 PlantUML 来创建安全架构图，适用于身份、加密、防火墙、合规和威胁检测等场景。它面向那些需要快速把安全设计转成可用于评审、审计或文档的清晰图示的人。

最适合的使用场景

当你的核心工作是解释 IAM 流程、零信任边界、加密管道、合规监控，或检测到响应的路径时，适合使用这个 security skill。它尤其适合 Security Audit、架构评审，以及需要精确安全模型而不是泛泛云架构图的文档。

为什么值得安装

它的主要价值在于 stencil 驱动的工作流：这个 skill 会引导你使用面向安全场景的图标、信任边界和方向流，让图更容易读，也更不容易标错。相比纯提示词，当你需要多次产出一致的安全图时，它会是更合适的选择。

如何使用 security skill

安装并打开正确的文件

使用 npx skills add markdown-viewer/skills --skill security 安装 security skill。然后先阅读 SKILL.md，再看最相关的示例，比如 examples/iam-authn.md、examples/zero-trust.md、examples/compliance-audit.md 和 examples/threat-detection.md。这些文件能比通读整个仓库更快地展示目标模式。

给出完整的安全目标

高质量输入描述的是安全任务，而不只是图的标题。比如，与其说“画一个安全架构”，不如明确要求“为员工和外包人员绘制一个零信任访问流程，包含 SSO、STS role assumption、网络边界检查和审计日志”。当你提供了参与方、信任边界、安全控制以及希望读者理解的结果时，这个 skill 的效果最好。

使用 skill 能跟上的工作流

一个好的 security 使用流程是：先定义安全目标，再列出信任区域，接着选择身份与防护组件，最后用正确的流向把它们连接起来。若你要画 Security Audit，请明确控制来源、证据存储、整改路径和汇报目标，这样图里才能同时体现控制和证据。

生成前先看语法规则

这个仓库对 PlantUML 格式要求很严格：要使用 @startuml / @enduml，访问流要保持从左到右，代码块只能用 ```plantuml 或 ```puml。它还要求使用 rectangle 作为信任边界，以及 mxgraph.aws4.* 的 stencil 语法，所以除非图确实需要，否则不要自行发明自定义形状。

security skill 常见问题

这个 security skill 适合通用云架构图吗？

不适合。仓库里明确说明不要把它用于通用云基础设施图；这类场景应该用面向云架构的 skill。这个 security skill 主要用于身份、加密、边界防护、合规或检测才是主线的图。

它适合 Security Audit 工作吗？

适合，尤其是在你需要展示证据流、策略检查、集中日志和整改闭环时。对于 Security Audit，最有说服力的图通常会把 Config、Audit Manager、CloudTrail、Security Hub，以及存储或报表输出组合起来，让审计路径从头到尾都清楚可见。

初学者不熟 PlantUML，也能用吗？

可以，但前提是需求里要有清晰的架构叙事。初学者如果先写出自己知道的参与方、信任区域和控制项，再让 skill 把这些内容转成安全图，效果会更好。模糊的提示词通常只会产出模糊的图。

什么情况下不该用它？

如果你只需要高层系统草图、产品总览，或者非安全的软件模型，就不应该用它。若你的主要关注点是计算拓扑、服务依赖关系，或通用 UML 结构，其他 skill 会更合适。

如何改进 security skill

从控制目标开始

最好的 security 输出都来自一个明确的目标：“阻止横向移动”“实施最小权限”“证明合规证据”或“检测并响应威胁”。这个目标会帮助 skill 选择合适的图标，以及在 Security Audit 或其他评审场景中该保留多少细节。

提供具体实体和边界

请给出明确输入，例如用户类型、身份提供方、受保护资源、审计汇聚点和执行点。比如，“员工通过 AD、客户通过 Cognito、STS 提供临时凭证、API Gateway，以及 CloudTrail 汇入集中日志归档”就远比“auth flow diagram”更有用。

避免把太多安全故事揉在一起

一个常见失败模式，是把 IAM、加密、网络安全、合规和事件响应塞进一张过载的图里。若初稿看起来过于拥挤，就把需求拆成多张图，每张图只保留一条安全主线，这样流程才更容易读。

补缺失信息，不要只改风格

如果结果在结构上是对的，但内容不完整，应该补缺少的控制点或证据路径，而不是只说“做得更好”。更有用的跟进方式包括：补上信任边界、展示异步审计流、加入静态加密，或把通用防火墙替换成这个场景下正确的 AWS security stencil。