前言¶

密码学设计容易出两类问题。一类是算法选错：用已不再安全的 SHA-1、用 ECB 模式加密，或在需要前向保密的场景里固定 DH 参数。另一类是工程落地缺失：密钥只有一份、轮换流程靠人工、证书到期才发现、端到端加密其实只做了传输加密。这些错误在代码评审里看不出来，一旦出事就是数据泄露。

下面介绍 SkillHub 上的一个 Skill，坐标 @org-02qudk26/crypt-zh，名称「密码学架构设计」，版本 1.0.0，由智雨科技以 enterprise 来源发布，分类 it-ops-security。它的作用是在设计阶段把这六件事交代清楚：算法选择、密钥管理、端到端加密、KMS 集成、签名验证、TLS 配置。

这是什么¶

这是一个面向架构设计阶段的提示型 Skill，不是运行时库，也不是密钥服务。它解决的问题是：当团队要设计密码协议、密钥轮换流程或端到端加密架构时，提供一个结构化的思考框架，避免遗漏关键决策点。

它不替代代码实现，也不直接操作 KMS。真正落地仍需后端工程师按设计文档编码，并按安全要求做密钥托管与访问控制。

核心功能¶

Skill 简介原文列出六项能力，逐项对应开发中容易出错的环节：

1、算法选择：确定对称加密、非对称加密、哈希、签名各自用哪类算法，以及模式与参数。
2、密钥管理：覆盖密钥生成、存储、分层、轮换与销毁，而不只写「生成一个 key」。
3、端到端加密：区分传输层加密与应用层加密，明确密文在哪些环节仍是明文。
4、KMS 集成：说明密钥托管边界、调用方与密钥的隔离方式。
5、签名验证：明确签名对象、签名算法、验证时机和密钥信任链。
6、TLS 配置：覆盖协议版本、套件、证书链与部署侧配置。

它的适用场景在简介里写得很具体：设计密码协议、设计密钥轮换流程、设计端到端加密架构。这三类是结构化决策密集的环节，正好是提示型 Skill 能发挥作用的地方。

安装与启用¶

官方页面没有给出命令行安装方式。已抓取资料里只有坐标 @org-02qudk26/crypt-zh、分类 it-ops-security 和标签 requires_api_key=false，没有安装命令、目录结构或配置文件路径。

因此这一步只说明启用方式：把该 Skill 作为提示词上下文提供给模型，在需要做密码学架构评审或设计时调用。是否需要 API Key：不需要（requires_api_key=false）。具体的加载方式以你所用客户端对 SkillHub Skill 的支持为准，本文未核实到官方安装命令，不猜测。

典型用法¶

官方资料没有提供可复现的示例。可确认的用法是把下面的任务描述交给 Skill：

• 设计一个客户端到服务端的端到端加密方案，明确密文在哪些组件里解密。
• 设计一套密钥轮换流程，覆盖应用密钥、数据加密密钥和主密钥的分层。
• 评审已有 TLS 配置，列出协议版本、套件和证书链的风险点。
• 设计消息签名与验证流程，明确签名者、验证者和撤销处理。

上面四类是简介覆盖的场景，不是官方示例。实际使用时建议附上当前技术栈、合规要求和密钥托管现状，输出才有针对性。

适用场景与注意¶

适合的读者是后端架构师、安全工程师，以及需要参与密码学方案评审的工程团队。适合的使用时机是设计阶段，而不是上线后排查。

有几点需要注意：

1、Skill 输出的是设计层面的结构化建议，不含可运行代码，不含密钥生成脚本，不含 KMS SDK 调用示例。
2、它不能替代安全审计。密钥权限策略、证书私钥保护、侧信道防护等仍需专门的安全评估。
3、端到端加密里的「端」需要你自己定义清楚，Skill 只能帮你列出必须定义的边界。
4、算法选型会随时间变化，输出中的建议应与当前主流标准交叉核对，不要直接当作永久结论。
5、requires_api_key=false 只表示使用该 Skill 不需要额外 API Key，不代表目标系统不需要密钥托管。

结尾¶

这个 Skill 的价值在于把密码学架构里分散的决策点收敛成六个可逐项检查的模块，适合在设计评审前用一轮提示把方案过一遍。它不是加密库，也不是安全审计服务，把它当成结构化的检查清单更合适。

官方地址：https://api.skillhub.cn/org-02qudk26/crypt-zh ，SkillHub 页面：https://www.skillhub.cn/skills/org-02qudk26/crypt-zh 。