1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | gdp-ts |
| 作者/维护者 | Guillermo Rauch(GitHub: rauchg,个人账号) |
| 来源链接 | https://github.com/rauchg/gdp-ts |
| 许可证 | MIT(GitHub API) |
| GitHub Stars / Forks | 700 / 18(GitHub API,2026-10-07) |
| 最新版本 | npm @gdp-ts/core 0.1.0;仓库创建于 2026-10-04,最近提交 2026-10-05 |
| 安装方式 | npx skills add rauchg/gdp-ts + pnpm add @gdp-ts/core |
数据来源:Stars、Forks、License、提交日期来自 GitHub API;npm 版本来自 npm registry。
2. 功能介绍与亮点
gdp-ts 是一个教 AI 编码代理(与人)在 TypeScript 项目里用「Ghosts of Departed Proofs」模式写授权/权益检查的技能,配套同名小型库与 lint 规则。
- 核心做法:给值起编译期名字(
name())→ 在受信任的proofs/模块里校验并签发证明(defineProof)→ 敏感函数把「证明」当参数。漏掉检查、拿错资源的检查结果、直接传裸 id,都会编译失败。 - 工作流:SKILL.md 给出 10 步操作清单(给 id 加品牌、复用或新增 proof、改敏感函数签名、处理 cookie/body 里的信任值、禁用
as强转等)。 - 参考资料:
references/含 recipe(六步采用法)、patterns、errors(类型报错对照)、limits(保证与不保证的边界)、where-to-stop(证明到哪为止)。 - 亮点:运行时开销接近零(每个
name只包一层冻结对象);自带 ESLint / Oxlint 预置规则补类型系统的缺口;明确声明「不是定理证明器,只证明漏掉会出事故的事实」。
3. 适用场景
分类:工程效率与代码质量。
- 在 TypeScript 后端新增/修改授权、订阅权益、资源归属检查
- 审计代码里「检查与使用脱节」的 IDOR、跨租户类缺陷
- 让 AI 代理改敏感代码时无法绕过检查,也无法拿别的资源的检查结果充数
- 受益人群:有一定 TypeScript 泛型基础、做多租户 SaaS/API 的中级开发者
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 标准 skills/<名>/SKILL.md 结构 + npx skills add 安装 |
| Codex | ⚠️ 需适配 | 同为 SKILL.md 格式,但需手动放置并显式引用 |
| OpenClaw | ❓ 未验证 | README 未提及 |
| Hermes Agent | ❓ 未验证 | README 未提及 |
5. 推荐理由
把「授权检查有没有做、做的是不是同一个对象」从靠人记变成编译器强制,且技能把采用步骤、常见报错和边界都写进 agent 可读的文档,适合想让 AI 改权限代码时更稳的团队。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 仓库创建 3 天即达 700 stars;issue 区有 coygeek、ArkashJ、ajoslin 等多位外部用户提交的具体缺陷与改进 |
| 可用性 | 7 | 安装两条命令;文档与 recipe 完整;需 TypeScript 5.4+,且要先在项目里引入库并建立 proofs/ 约定,有一定采用门槛;项目很新(0.1.0) |
| 安全性 | 9 | 技能为纯文档;库无依赖、无外联;MIT |
综合 = 三项均值 = 7.33。
安全检查清单:① 技能本身不执行 shell 命令 ✅ ② 运行时不联网外发 ✅ ③ 无需 API key ✅ ④ SKILL.md 与 references 中未见可疑指令 ✅ ⑤ 作者为公开身份的知名开发者 ✅ ⑥ MIT 明确 ✅ ⑦ 最近提交 2026-10-05,活跃 ✅。
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 与 gdp-ts 的差异 |
|---|---|---|
品牌类型(Zod .brand、Effect Brand 等) |
区分不同种类的 id | 只防「传错类型」,不表达「已对这个具体对象做过某检查」 |
| 运行时授权库(CASL、Casbin、OPA 等) | 集中定义并在运行时求值权限策略 | 不阻止开发者漏调用;gdp-ts 让漏调用无法通过编译 |
| 通用 TypeScript 编码指南类技能 | 泛泛的类型/风格建议 | 不针对授权证明模式 |
核心差异:专攻「检查与使用必须绑定同一对象」,并配套 lint 与 AI 代理工作流。
8. 用户评价
- coygeek(GitHub issues #13–#16):提交了 lint 规则漏判(如经本地模块重导出的
defineProof、!/any伪造 proof)等多条可复现缺陷,说明有人在真实项目里压测该模式。 - ArkashJ(GitHub issues/PR #3–#12):提交示例代码、benchmark 退出码等修复与 PR。
- ajoslin(GitHub issue #11):指出展开已命名值会保留名字却替换 id 的边界问题。
10. 安装使用方式
npx skills add rauchg/gdp-ts
pnpm add @gdp-ts/core
安装后在 TypeScript 项目中提到授权/权益检查、Named、Proof、defineProof 时技能会被触发;建议按 references/recipe.md 先配置 lint 预置。
11. 注意事项
- 项目创建不久,版本 0.1.0,API 可能变动
- 类型层保证有边界:伪造(
as/any)、过期证明、较旧 TypeScript 版本见references/limits.md - 仅适用于 TypeScript;技能依赖
@gdp-ts/core库,不用该库则无意义