ClaudeMap

gap-trap

把 vibe coding 变成高质量代码：这个 agent skill 会替你的仓库写出该守的规矩，并把每条规矩变成 agent 绕不过去的闸门。

技能与命令skillcode-qualitycigatescontracts
访问项目pliablepixels/gap-trap

失败模式很眼熟：agent 写了大部分代码，你不再逐行读 diff，质量悄悄漂移直到某天炸掉。在仓库里跑一次 /gap-trap setup，它会读代码、写出贴合这套代码库的规则，并为每条规则加一道闸门——规则被破坏时让 commit 或 CI 直接失败。它布置四样东西：Contracts（HTTP、日志、配置、鉴权这些「只有一种正确写法」的地方各立一条）、Proven red（一个 CI 任务把每条新测试放到旧代码上跑，测试在旧代码上也通过就判失败——不能失败的测试证明不了任何事）、Ratchets（已知问题计数——lint 积压、超 400 行的文件——只许降不许涨）、Playbooks（项目用血泪换来的事实，写下来让下一个会话别再学一遍）。它还会顺手装上姊妹 skill slop-mop，让文档、commit 信息和 PR 描述读起来像人写的。任何语言都适用：Node 和 Python 仓库的闸门装进测试套件；其余——Go、Rust、Java、Ruby、.NET、PHP、Swift、C++——用只需 git、grep、awk 加你的测试命令的 shell 版本。

它做什么

  • 一次 /gap-trap setup：读仓库、给出简短计划、写合同与闸门、逐条证明闸门为红，然后 commit——它从不 push
  • 四件套：contracts、proven-red CI、ratchets、playbooks——agent 绕不过闸门，因为闸门让构建失败，而不是靠自觉
  • /gap-trap refine 约每月一次：找没有闸门的规则、指向已删代码的合同、commit 历史里没人记下来的教训；产出恰好一个 PR
  • 顺手安装姊妹 skill slop-mop，让 agent 的文档、commit 信息和 PR 描述像人话；从下一个会话起 harness 会自动加载

什么时候用

没人逐行读 diff 的 agent 重度仓库；也适合作为 spec-driven development 的内环补充。这套框架正是 zmNinjaNg 在用的那套，其「Agent 开发模型」一章是出处。

如何上手

npx skills add pliablepixels/gap-trap

# 或手动安装（Claude Code 读 ~/.claude/skills，Codex 读 ~/.agents/skills）：
git clone https://github.com/pliablepixels/gap-trap.git
mkdir -p ~/.claude/skills
cp -r gap-trap/gap-trap ~/.claude/skills/

# 然后在目标仓库里：
/gap-trap setup

注意事项

MIT。这个 skill 刻意拒绝在小模型上运行（Claude Code 里要求 Opus 或更强，Codex 里要求高推理档的前沿编码模型）——合同选错一次，之后每个会话都跟着买单。源头仓库的完整闸门集（4,400 个单元测试、一次构建、三个 lint）本地约一分钟跑完；proven-red 只在 CI 跑。更新用 npx skills update gap-trap；手动安装应整目录替换，免得上游已删除的文件残留。

代码仓库

pliablepixels/gap-trap

收录日期

地图上的相关资源

  • guizang-product-video-skill

    技能

    归藏的 Agent Skill：把代码库的最近更新做成一支成片宣传片——接真实组件、代码渲染动画、代码写配乐，全程不碰视频剪辑软件。

    • agent-skill
    • video
    • promo
    • marketing
    查看

  • geo-sleuth

    技能

    一个给「图里没有任何文字线索」的照片做地理定位的 Agent Skill——用 OSM 几何、高程天际线与卫星瓦片，把「这是哪」变成带误差半径的测量答案。

    • agent-skill
    • geolocation
    • osint
    • openstreetmap
    查看

  • Birdview

    技能

    让 AI 编码 agent 在动第一行代码之前先画出架构、声明影响范围的 skill——成果是一张可直接打开的独立 HTML 架构地图。

    • skill
    • architecture
    • code-visualization
    • change-scope
    查看