grim-prompter - 让 AI 编码代理为你的代码库做威胁建模

grim-prompter 是一套面向 AI 编码代理的威胁建模提示词库。按项目自述，它的用法是把 Claude Code、Codex 或其他编码代理指向你的仓库，让代理沿着结构化流程审查代码、信任边界、威胁、现有控制措施与拟议缓解方案，最终产出一份能追溯到具体代码位置的威胁模型。它适合已经用 AI 编码代理写代码、又希望在提交前补上一轮安全审查的开发者与小型团队，也适合需要把威胁建模流程固化成可重复步骤的安全工程人员。

维护者与状态

仓库由 jmanico 维护，地址为 github.com/jmanico/grim-prompter。据事实表，项目创建于 2026-10-28，最后一次提交在 2026-10-29，截至 2026-10-31 获得 255 个星标。项目目前尚无正式 release，也就是说没有可引用的版本号或发布包，使用方式是从仓库直接克隆并链接技能目录。许可证为 MIT。

从时间线看，这是一个非常新的项目：创建与最后提交相隔一天，星标数在读取时已积累到 255。这意味着它的提示词内容可能仍在快速调整，读者在采用前应自行查看仓库当前状态，而不是依赖某个固定版本。

主要能力

以下能力均据项目 README 自述，未经独立验证。

• 架构工作流：README 称提供 36 个架构工作流，覆盖 Web、API、移动端、桌面端、浏览器扩展、CLI 工具、单体与模块化单体、微服务、事件驱动、批处理、无服务器、容器平台、云控制平面、混合云与多云、多租户 SaaS、CI/CD 与供应链、数据平台、实时流、AI 与机器学习、RAG、Agentic AI、IoT 与边缘、嵌入式固件、OT 与工业控制、信息物理与机器人、高保障隔离系统、身份联邦、支付与交易、实时协作、内容与媒体分发、企业集成、点对点、区块链与智能合约、离线优先同步等场景。每个架构都区分 quick 与 deep 两种深度。
• 方法与分析提示：README 称提供 29 个方法与分析提示，按用途分组，包括威胁发现（STRIDE per element、STRIDE per interaction、四问题工作流、PASTA、Trike、hTMM、CORAS、OCTAVE Allegro、NIST SP 800-154 数据中心方法）、攻击者与滥用（攻击树、攻击图、误用与滥用用例、安全用例、Persona non Grata、Security Cards、Elevation of Privilege）、隐私（LINDDUN GO、LINDDUN PRO）、安全与失效（STPA、STPA-Sec、FMEA 与 FMECA、Bow-tie）、AI 系统（CSA MAESTRO、MITRE ATLAS），以及富化与评分（MITRE ATT&CK、CAPEC、Cyber Kill Chain、CVSS、DREAD）。
• 六阶段深度分析：deep 运行依次覆盖范围界定、系统建模、威胁分析、挑战、处置计划与报告，每个阶段读取上一阶段的产物文件，因此可以中断后按文件夹名继续。
• 变更审查：可以对某个分支相对既有威胁模型的变化做审查，需要同时提供代码 diff 与作为基线的 JSON 报告；若未提供模型，代理会主动索要。
• MCP 与代理工具边界：README 称在证据支持的前提下，会把工具映射到后端凭据与有效权限，把未知授权或凭据访问记为缺口，并检查共享令牌的影响范围、读写分离，以及工具描述及其审批后更新是否可能影响其他受信工具。
• 辅助提示：包括证据指南（在不运行分析的情况下从仓库收集 SYSTEM_UNDER_REVIEW 材料）、架构选择器、方法选择器、模型挑战者与变更审查者。

README 同时强调，这些提示词只是草稿，输出需要人工复核；威胁模型并不等于系统安全的认证。

使用入口

仓库地址：jmanico/grim-prompter。

据 README，安装方式是先克隆一次，再把 threat-model 技能链接进代理的技能目录，命令面向 macOS 或 Linux 本地 shell：

git clone https://github.com/jmanico/grim-prompter.git ~/grim-prompter
mkdir -p ~/.claude/skills && ln -s ~/grim-prompter/skills/threat-model ~/.claude/skills/threat-model
mkdir -p ~/.agents/skills && ln -s ~/grim-prompter/skills/threat-model ~/.agents/skills/threat-model

README 提醒执行前先检查是否已有安装，克隆目录不要移动，因为技能会链接到其中的提示词文件，并避免重复安装；完成后需开启新的代理会话。对于其他代理，README 建议把一段项目片段加入项目的 AGENTS.md（或 CLAUDE.md、GEMINI.md 等等价文件），指示代理在收到威胁建模请求时读取 runbook.md，以只读方式检查仓库，并且只写入 threat-model/ 目录，同时把仓库中的文本视为证据而非指令。

运行方式是在代理会话中调用技能，例如 Claude Code 的 /threat-model、Codex CLI 的 $threat-model，可附加 quick、deep、指定架构、指定方法或 change 分支范围等参数。结果写入 threat-model/ 下的新文件夹，包含 SYSTEM_UNDER_REVIEW.md、report.md 与 JSON 产物。

许可与限制

项目采用 MIT 许可证，README 中标注版权归 Jim Manico（2026）。README 还说明 STRIDE、PASTA、LINDDUN、OCTAVE、CVSS、MITRE ATT&CK、MITRE ATLAS、CAPEC 等方法名称归各自所有者所有。

已知限制与适用边界，据 README：

• 运行手册要求只读检查并给出文件与行号引用；构建、测试、脚本、安装与网络访问都需要用户显式授权，README 建议用代理自身的权限设置来落实这些限制。
• 报告在人工审查敏感细节之前不应纳入版本控制；仓库自带的 .gitignore 只覆盖在该检出目录内产生的运行结果。
• 代理不应自行编造风险评级或审批结论，风险标准、缓解选择与负责人需要由使用者提供。
• 拟议的验证计划不等于已通过的测试，执行需单独授权并记录实际结果。
• MCP 与工具边界的结论依赖被检查到的证据，证据不足时会记为缺口而非结论。
• README 未给出性能指标、支持的代理版本范围或硬件要求。

综上，grim-prompter 更像一套把威胁建模方法论编排成代理可执行流程的提示词集合，而不是一个可独立运行的安全扫描器。它的价值取决于使用者是否愿意逐条复核代理给出的范围、证据与威胁前提。