pm-skills intended-vs-implemented方法论:如何3步找出文档与代码之间的危险差距(完整指南)
pm-skills intended-vs-implemented方法论如何3步找出文档与代码之间的危险差距完整指南【免费下载链接】pm-skillsPM Skills Marketplace: 100 agentic skills, commands, and plugins — from discovery to strategy, execution, launch, and growth.项目地址: https://gitcode.com/GitHub_Trending/pm/pm-skillspm-skills 的intended-vs-implemented 方法论是一套专门用来找出「文档与代码之间的危险差距」的审计方法先写下系统应该做什么意图再到代码里逐条验证实际做了什么实现把两者对不上、且跨越信任边界的不一致当成真正的安全发现来报告。对使用 AI 生成代码的项目来说这恰好能抓住通用扫描器发现不了的那一类漏洞。pm-skills 是一个面向产品经理的技能市场Skills Marketplace包含 100 个 agentic 技能、命令和插件覆盖从产品发现、战略、执行到上线和增长的完整流程。而本文的主角intended-vs-implemented属于其中专为AI 构建的代码服务的pm-ai-shipping插件为什么文档和代码会各说各话 ️AI Agent 写代码很快但它不会留下任何关于意图的记录——系统应该做什么、谁被允许做什么、密钥放在哪里。没有这份记录没有任何人类或审计 Agent 能判断代码是否安全可发布。这就是最危险的差距所在危险差距示例后果文档说仅管理员可调用代码里根本没做权限校验任意用户可越权操作文档说cron-only 接口实际任何人可调用定时任务被伪造触发字段标注仅公开数据查询却带出私有字段隐私数据泄露静态扫描器linter是在真空中扫代码它只能告诉你代码内部自洽无法告诉你代码是否做了你本意要做的事——因为它没有你的意图模型。而最有价值的安全与正确性 Bug恰恰就活在这个差距里。方法核心把意图当假设把代码当证据 完整定义见 intended-vs-implemented/SKILL.md方法可以拆成 3 大步第 1 步确立意图文档即待验证的声明把/documentation/*.md如permissions.md、architecture.md、flows.md当作应该为真的声明源来读。关键心态文档是待验证的声明不是证明。如果这些文档不存在或已过时——无法审计你从未记录的意图本身就是第一条发现应先补文档再审计。第 2 步收集实现证据引用文件 行号才算数对每条文档声明去读真正执行或遗漏执行它的代码实际的鉴权检查、实际的查询过滤、实际的清洗器。上游应该有处理不算证据代码路径才是证据。像 internal only、validated elsewhere 这样的注释一律不可信必须到代码里验证。第 3 步逐边界对比 分级 拒绝含糊结论逐条对比每条文档规则都问——在服务端、在所有路径上是否真的存在执行点判断是否重要跨越这条差距后真实攻击者能否触达不该碰的数据、资金、基础设施或其他租户能才值得报告只影响操作者自己的数据则丢弃。拒绝含糊每条发现必须包含四要素——文档原文引用意图、代码引用实现、攻击者与受害者、具体修复方案。引不出两侧的差距只是待调查的问题不是发现。前置条件先用 shipping-artifacts 把意图写下来 这套方法只在意图先被写下时才生效——这正是它难以被商品化工具复制的原因。配套的 shipping-artifacts/SKILL.md 定义了让 AI 构建的应用可被审查的最小文档集通过/document-app命令反向工程生成存放在/documentation/下核心文档每款应用都需要architecture.md架构与信任边界、flows.md权限实际被执行的旅程、permissions.md资源 × 操作 × 角色矩阵、variables.md配置与密钥的风险映射条件文档有该能力才写emails.md、cron.md、seo.md、automation.md——不适用就写一行无绝不虚构空文档tests.md由/derive-tests从上述文档推导出的测试覆盖地图把每条规则标注为existing / proposed / none三档防止地图虚假变绿一键实操/ship-check 发布前完整检查 如果不想逐条执行ship-check.md 定义的/ship-check命令会按正确顺序跑完整个流程——顺序本身就是重点因为每次审计的质量只取决于它能对比的意图文档质量文档化系统/document-app缺失或过时则先生成生成 Agent 上下文从系统文档派生出CLAUDE.md/AGENTS.md安全审计security-audit-static.md应用 intended-vs-implemented 方法标记代码偏离permissions.md、flows.md之处并自反驳每条候选发现性能审计performance-audit-static.md过度取数、缺失索引、缓存机会推导测试覆盖derive-tests.md让审计中每个确认的发现变成一条回归测试防止同一差距在下次 AI 编辑后悄悄重现编译 Shipping Packet文档清单、测试覆盖、安全/性能摘要、发布阻断项Launch Blockers与建议行动供人工签核审计输出遵循固定格式严重级别 · 攻击场景 · 影响 · 修复方案并会明确写出哪些地方建得好以及无法验证、需要人工复核的部分——这是一次代码评审不是安全保证。如何安装 pm-ai-shipping 插件 ⚙️克隆 pm-skills 仓库git clone https://gitcode.com/GitHub_Trending/pm/pm-skills在你的 AI 编码工具中通过 Add marketplace 添加该仓库启用pm-ai-shipping插件安装后即可触发命令完整说明见 pm-ai-shipping/README.md命令作用/pm-ai-shipping:ship-check完整发布检查序列产出 Shipping Packet/pm-ai-shipping:document-app反向工程出审查所需系统文档/pm-ai-shipping:security-audit-static静态安全审计应用本方法论/pm-ai-shipping:performance-audit-static静态性能审计/pm-ai-shipping:derive-tests把文档意图转成测试覆盖地图新手常见误区 ⚠️没写文档就审计没有意图记录时文档缺失才是第一条发现先跑/document-app把注释当证据应该在上游处理了 不算数必须引用到具体文件与代码路径把所有不一致都报成漏洞只报告跨越信任、数据、租户边界的差距丢弃表面漂移编造意图来制造差距文档沉默时就如实说文档沉默把 proposed 测试当已有覆盖tests.md中只有仓库里真实存在的测试才标 existing小结 ✅intended-vs-implemented 方法论的精髓一句话已记录但没执行本身就是一条发现已执行但没记录则是文档过期的信号。它为安全与性能审计补上了通用工具缺失的意图轴让 AI 构建的代码在发布前真正可审查。想做的事入口理解方法论pm-ai-shipping/skills/intended-vs-implemented/SKILL.md生成意图文档pm-ai-shipping/skills/shipping-artifacts/SKILL.md一键发布检查pm-ai-shipping/commands/ship-check.md单独跑安全审计pm-ai-shipping/commands/security-audit-static.md【免费下载链接】pm-skillsPM Skills Marketplace: 100 agentic skills, commands, and plugins — from discovery to strategy, execution, launch, and growth.项目地址: https://gitcode.com/GitHub_Trending/pm/pm-skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

CLIP优化重塑ASCII art:从亮度映射到语义引导的字符画生成

CLIP优化重塑ASCII art:从亮度映射到语义引导的字符画生成

如果你曾经用过在线图片转字符画工具,大概会有一个共同体验:字符画确实有意思,但总差点意思。轮廓勉强能看,细节常常糊成一团,稍微复杂的图片转出来就是一坨灰蒙蒙的“缩略图灰度图”。做这类工具的人通常也不太纠结&a…

2026/11/22 8:15:44 阅读更多 →
Umi-OCR 完整指南:免费离线 OCR,从截图取字到批量识别与自动化集成

Umi-OCR 完整指南:免费离线 OCR,从截图取字到批量识别与自动化集成

Umi-OCR 完整指南:免费离线 OCR,从截图取字到批量识别与自动化集成 【免费下载链接】Umi-OCR OCR software, free and offline. 开源、免费的离线OCR软件。支持截屏/批量导入图片,PDF文档识别,排除水印/页眉页脚,扫描/…

2026/11/22 8:15:44 阅读更多 →
Airflow 3.1 调度 Flink 与 Kafka 数据管道:架构、配置与验证清单

Airflow 3.1 调度 Flink 与 Kafka 数据管道:架构、配置与验证清单

Airflow 3.1 调度 Flink 与 Kafka 数据管道:架构、配置与验证清单 【免费下载链接】airflow Apache Airflow - A platform to programmatically author, schedule, and monitor workflows 项目地址: https://gitcode.com/GitHub_Trending/ai/airflow 如果你需…

2026/10/26 13:36:37 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/21 23:27:35 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/21 23:27:35 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/21 23:27:35 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/21 23:27:35 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/21 23:27:36 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/21 23:27:37 阅读更多 →

日新闻

周新闻

月新闻