pytm 威胁建模助手 Skill 技能

技能简介

agentsecops-pytm（pytm 威胁建模） 把威胁建模从"一次性画图"变成可重复、可进 CI 的代码化工作流。它围绕 pytm（用 Python 描述威胁模型的框架）提供从建模、STRIDE 分析到图表生成、CI 检查的完整套路：定义参与者、信任边界、组件与数据流，按欺骗、篡改、抵赖、信息泄露、拒绝服务、权限提升六个维度逐项走查，最终产出 Graphviz 架构图、威胁报告与缓解措施清单。技能在 Skillstore 质量评分 81 分（silver 档），riskLevel 为 safe，已完成安全审计，支持 Claude、Codex、Claude Code，采用 MIT 许可。

核心能力

• 结构化建模引导：指导定义 actors、boundaries、components、data flows 四类要素，搭出第一版 pytm 模型。
• STRIDE 六维走查：逐项解释欺骗、篡改、抵赖、披露、拒绝、提权六类威胁的审查步骤。
• Python 模式库：提供 Web 应用、微服务、自定义威胁、信任边界、风险评分等场景的代码示例。
• CI 工作流方案：给出生成图表、产出威胁报告、标记未缓解高危项的流水线设计思路。
• 敏感信息处理规范：覆盖架构细节、报告、仓库与评审记录的安全处理方式。
• 排障手册：针对威胁遗漏、Graphviz 图渲染失败、误报、模型漂移给出排查步骤。

安装配置

1. 在项目目录执行 npx skillstore add agentsecops/pytm 完成安装。
2. 技能包内仅含 SKILL.md 主文档，引用的脚本与模板不随包分发，需按文档指引另行获取。
3. 命令示例会安装 Python 包、运行本地脚本甚至使用 sudo，必须在用户明确批准后、于受信仓库或受控虚拟环境/CI Runner 中执行。
4. 技能涉及外部命令与网络访问，风险因素已在 Skillstore 标注，建议只在授权范围内使用。

使用步骤

1. 起步建模：对三层 Web 应用发起建模请求，先产出包含参与者、信任边界、数据流与初始 STRIDE 关注点的初版模型。
2. 架构预审：把现有架构描述交给它审一遍，找出缺失的边界、敏感数据流与安全属性，再动笔写模型。
3. 补齐缓解项：对识别出的威胁逐条给出缓解建议，输出可评审的威胁模型文档。
4. 接入 CI：设计流水线，自动生成图表、产出威胁报告，并对未缓解的高危威胁置为失败。
5. 人工复核：对可能性、影响与缓解质量做最终判断，生成的 STRIDE 结论不能直接当风险决策。

适用场景

• 架构评审前置：评审会前先产出第一版 pytm 模型与关键 STRIDE 威胁清单。
• CI 威胁检查：架构变更时自动重建模型并拦截未缓解的高危项。
• 应用安全文档化：把服务边界、敏感数据流与缓解措施转成可评审的安全文档。
• 组织威胁库定制：定义企业自有的威胁条目、风险评分标准与 API/云存储类控制项的缓解说明。

适用人群

应用安全工程师、安全架构师、DevSecOps 与平台安全团队，需要为合规或评审补齐威胁建模文档的开发团队，以及希望把安全检查纳入流水线的技术负责人。

工作原理

技能先引导按"参与者—信任边界—组件—数据流"四要素描述系统，生成 pytm 模型骨架；再套用 STRIDE 框架对每条数据流做六维检查，参照内置的 Python 示例模式补全属性与评分；随后通过 Graphviz 渲染架构图、汇总成威胁报告，并可在 CI 中对未缓解高危项报警。它明确要求模型与架构文档放在一起维护——边界或数据流变更时同步更新；凭据、令牌、客户数据一律用占位符表示。安全审计未发现提示注入或恶意意图，仅提醒其中的命令示例会装包、跑本地 Python 或用 sudo，需批准后在受信环境执行。

官方链接

• 技能主页：https://skillstore.io/skills/agentsecops-pytm
• 源码仓库：https://github.com/AgentSecOps/SecOpsAgentKit/tree/main/skills/threatmodel/pytm
• 技能清单：https://skillstore.io/api/skills/agentsecops-pytm/manifest