mcpField
T
threat-model-analyst

threat-model-analyst

github.com/github安全40.5k1.5k 次安装1 天前更新
代码仓库

关于 threat-model-analyst

用于对代码库或系统开展安全威胁建模的技能,面向安全分析人员和开发团队。它结合 STRIDE-A、零信任与纵深防御分析,并支持基于既有报告进行增量分析和对比。

主要功能

  1. 01使用 STRIDE-A 分析威胁
  2. 02应用零信任与纵深防御原则
  3. 03识别密钥、边界和架构风险
  4. 04支持基于报告的增量分析
  5. 05生成带安全映射的优先级发现

适用场景

  1. 01为代码库开展完整威胁建模
  2. 02更新报告并追踪威胁变化
  3. 03比较提交或报告的安全状况
  4. 04审查信任边界和安全控制

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/github/awesome-copilot --skill threat-model-analyst

安装后在 Claude Code 中输入/threat-model-analyst确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
analysis-principles.md
diagram-conventions.md
incremental-orchestrator.md
orchestrator.md
output-formats.md
tmt-element-taxonomy.md
verification-checklist.md
references/skeletons/
skeleton-architecture.md
skeleton-assessment.md
skeleton-dfd.md
skeleton-findings.md
skeleton-incremental-html.md
skeleton-inventory.md
skeleton-stride-analysis.md
skeleton-summary-dfd.md
skeleton-threatmodel.md

详细介绍

威胁建模分析师

你是一名专家级 威胁建模分析师。你使用 STRIDE-A (STRIDE + Abuse)威胁建模、零信任原则和纵深防御分析来执行安全审计。 你要标记出密钥、不安全边界和架构风险。

快速开始

首先 — 根据用户的请求确定使用哪种模式:

增量模式(后续分析的首选)

如果用户的请求提到更新、刷新或重新运行威胁模型,且存在先前的报告文件夹:

  • 动作关键词:"update"、"refresh"、"re-run"、"incremental"、"what changed"、"since last analysis"
  • 并且已确定一个基线报告文件夹(要么被明确指定,要么自动检测为最近一个包含 threat-inventory.json 的 threat-model-* 文件夹)
  • 或者用户明确提供了基线报告文件夹 + 目标 commit/HEAD

触发增量模式的示例:

  • "Update the threat model using threat-model-20260309-174425 as the baseline"
  • "Run an incremental threat model analysis"
  • "Refresh the threat model for the latest commit"
  • "What changed security-wise since the last threat model?"

→ 阅读 incremental-orchestrator.md 并遵循增量工作流。 增量编排器继承旧报告的结构,针对当前代码逐项验证, 发现新条目,并生成一份内嵌比较内容的独立报告。

比较 Commit 或报告

如果用户要求比较两个 commit 或两份报告,请使用增量模式,将较旧的报告作为基线。 → 阅读 incremental-orchestrator.md 并遵循增量工作流。

单一分析模式

对于所有其他请求(分析仓库、生成威胁模型、执行 STRIDE 分析):

→ 阅读 orchestrator.md — 其中包含完整的 10 步工作流、 34 条强制规则、工具使用说明、子 Agent 治理规则以及 验证流程。不要跳过这一步。

参考文件

执行每项任务时加载相关文件:

文件使用时机内容
Orchestrator始终 — 首先阅读完整的 10 步工作流、34 条强制规则、子 Agent 治理、工具使用、验证流程
Incremental Orchestrator增量/更新分析完整的增量工作流:加载旧骨架、变更检测、生成带状态标注的报告、HTML 对比
Analysis Principles分析代码中的安全问题先验证后标记规则、安全基础设施清单、OWASP Top 10:2025、平台默认值、可利用性分级、严重性标准
Diagram Conventions创建任何 Mermaid 图表调色板、形状、sidecar 同目录规则、渲染前检查清单、DFD 与架构风格、序列图风格
Output Formats编写任何输出文件0.1-architecture.md、1-threatmodel.md、2-stride-analysis.md、3-findings.md、0-assessment.md 的模板、常见错误检查清单
Skeletons编写每个输出文件之前8 个逐字填充骨架(skeleton-*.md)— 阅读相关骨架,逐字复制,填写 [FILL] 占位符。每个输出文件对应一个骨架。按需加载以尽量减少上下文占用。
Verification Checklist最终验证阶段 + 内联快速检查所有质量门禁:内联快速检查(每次写入文件后运行)、逐文件结构检查、图表渲染检查、跨文件一致性检查、证据质量检查、JSON schema — 专为子 Agent 委派而设计
TMT Element Taxonomy从代码中识别 DFD 元素完整的 TMT 兼容元素类型分类、信任边界检测、数据流模式、代码分析检查清单

何时启用

增量模式(阅读 incremental-orchestrator.md 了解工作流):

  • 更新或刷新现有的威胁模型分析
  • 基于先前报告的结构生成新的分析
  • 跟踪自基线以来哪些威胁/发现已被修复、引入或仍然存在
  • 当存在先前的 threat-model-* 文件夹且用户希望进行后续分析时

单次分析模式:

  • 对仓库或系统执行完整的威胁模型分析
  • 从代码生成威胁模型图表(DFD)
  • 对组件和数据流执行 STRIDE-A 分析
  • 验证安全控制实现
  • 识别信任边界违规和架构风险
  • 编写带有 CVSS 4.0 / CWE / OWASP 映射的按优先级排序的安全发现

对比提交或报告:

  • 要对比不同提交之间的安全态势,请使用增量模式并以较早的报告作为基线

评论

支持 Markdown