vibe-coding-survival

vibe-coding-survival is a skill for Claude Code, Codex from Junliu1066/vibe-coding-kit. It costs 212 tokens per session (2,309 once invoked), scanned A, original, MIT.

A practical guide for managing projects built with AI that writes code, often called vibe coding. It covers keeping decisions recorded, limiting the work in progress, saving usable versions, and checking that changes really work.

In plain words
What is it for?
Use it throughout an AI-assisted project to manage conversations, preserve backups, control feature requests, verify completed work, and identify situations requiring a human engineer.
Why use it?
AI can forget earlier decisions, expand the project beyond its intended scope, break working code, or claim a task is finished without proving it.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/junliu1066/vibe-coding-kit/vibe-coding-survival
Any agent
npx skills add Junliu1066/vibe-coding-kit --skill vibe-coding-survival
Clone the repo
git clone --depth 1 https://github.com/Junliu1066/vibe-coding-kit

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for vibe-coding-survival

README.md
[![agentmods](https://agentmods.dev/badge/skills/junliu1066/vibe-coding-kit/vibe-coding-survival.svg)](https://agentmods.dev/skills/junliu1066/vibe-coding-kit/vibe-coding-survival)
Your own site
<a href="https://agentmods.dev/skills/junliu1066/vibe-coding-kit/vibe-coding-survival"><img src="https://agentmods.dev/badge/skills/junliu1066/vibe-coding-kit/vibe-coding-survival.svg" alt="Measured on agentmods" height="20"></a>
Per session 212 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,309 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00212 $0.02309
Opus 5 $0.00106 $0.01154
Sonnet 5 $0.00042 $0.00462
Haiku 4.5 $0.00021 $0.00231

Measured 5d ago against content hash dc0c874cf478, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

vibe-coding-survival scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/vibe-coding-survival/SKILL.md · 138 lines

How it starts

The opening of the file, as written. The whole thing — 138 lines — stays where its author put it; the contents beside it link to each section on GitHub.

开发避坑与自救:贯穿全程的纪律

这是 vibe-coding-kit 里贯穿整个开发过程的 Skill。前面几个 Skill 是"开工前想清楚",但 Vibe Coding 真正翻车,大多发生在"开工后"。下面这些不属于某个阶段,要在整个开发过程里持续做。对不写代码的人来说,这几件事比任何技术选型都重要。

配套:vibe-coding-requirements(需求)、vibe-coding-architecture(选型)、vibe-coding-production(上线)。

流程角色: 本 skill 是 harness.json 里的 always_on——不占流水线某一阶段,而是全程在跑。它和账本(docs/进度账本.md)的关系有两条:① 卡住、改坏、改不动时,把问题记进账本的「阻塞项」;② 红线(动钱 / 动别人隐私)是硬提示,一旦触及,不管在哪个阶段都要停下来提醒用户找真人把关——这条优先级高于"按门推进"。


一、贯穿全程的四件事

1. 管理好和 AI 的对话(最易忽略,却最致命)

AI 在长对话里会"忘事"——聊久了它会忘记早先的决定、自相矛盾,甚至改坏之前好的部分。对策:

  • 维护一份项目说明书(见第三节),每开一个新对话,先把它整段贴进去。
  • 一个功能做完、对话变得又长又乱时,果断开新对话,别恋战。
  • 重要决定(选了什么技术、定了什么规则)随手记进说明书,别只存在对话里——对话会丢、会乱、会被你关掉。

2. 守住范围(别让 demo 越长越大)

做着做着冒出"要不再加个……",AI 每次都说行,于是越加越多、越来越脆,最后全盘崩掉。对策:

  • 准备一个"以后再说"清单。新点子先记进去,不打断当前这件事。
  • 当前这件事彻底做好、能用了,再回头看清单,挑真正值得的做。一次只推进一件事。

3. 保住能用的版本(别把唯一能跑的版本改坏)

非技术用户最痛的事:改着改着坏了,又退不回去,之前能用的也没了。对策:

  • 每当一个版本"能正常用",就完整复制一份存好(比如把整个文件夹复制成 项目-2024-06-能用版)。
  • 之后再大胆改也不怕,坏了就从备份拿回来。
  • 懂 git 的话用 git 更专业;但对不写代码的人,"复制整个文件夹"是最朴素可靠的保险,别嫌土。

4. 让 AI 证明给你看(别轻信"我做好了")

AI 经常很自信地说"已完成",但实际没跑通——它不是骗你,是它自己也没真运行过。对策:

  • 每次它说做好了,就追问:"我怎么自己验证它真的好了?给我具体步骤。"
  • 然后你亲手按步骤跑一遍。没亲眼看到它在你这儿跑通,就别当它做完了。

二、⚠ 红线:这些情况,请找真人工程师把关

有些事,一个不写代码的人靠 AI 单干风险太高,一个 bug 就可能是真金白银或法律责任。碰到下面这些,强烈建议找一个懂行的人帮你过一遍,别全压在 AI 身上:

  • 真实收付款 / 动到钱:自己接支付、转账、扣费、管钱。出错就是真实损失。
  • 存别人的个人信息:手机号、身份证、住址、聊天记录等。这涉及隐私和法律合规,做错可能违法。
  • 出错有真实后果的场景:医疗、安全、合同、关键业务等。
  • 要给很多人用、且一旦挂掉影响很大的系统。

会判断"哪些我能自己搞定、哪些该收手找人",本身就是行家的一部分。能看懂架构(见 vibe-coding-architecture)会让这个判断更准。


三、📄 你的项目说明书(把一切串起来)

各个 Skill 的产出,汇总进一个文档,这就是你的"项目说明书"。它有两个作用:① 让你随时看得懂自己的项目;② 每开新对话先整段贴给 AI,直接解决"AI 忘事"。

完整可复制的模板见仓库 examples/项目说明书-模板.md。骨架:

【项目说明书】
· 一句话:这个项目是做什么的
· 需求基准描述:……
· 选定技术栈:…… / 为什么选它
· 目录结构:……
· 开发规范要点:……
· 安全清单:……
· 部署步骤:……
· 验收清单:……
· "以后再说"清单:……
· 当前进度 / 还剩什么没做:……
· 能用版备份在哪:……

让 AI 帮你维护它:

"每次有重要改动,提醒我该更新项目说明书的哪一部分。"


关键原则速查(全套件通用)

原则 含义
需求没说清,等于没说 AI 会朝着模糊的方向飞速跑偏
先说问题,再说方案 描述方案会锁死 AI,描述问题才有更优解
AI 会忘事 长对话里它会丢失上下文,靠项目说明书兜底
一次只推进一件事 范围一散,项目就脆
先备份,再动手 永远留一个能用的版本可退回
没亲眼跑通,就不算做完 别轻信 AI 的"已完成"
复杂度是负债 每引入一个组件,都是在向未来借债
你有权说不 AI 推荐的任何东西都是可选的
没有代价的方案不存在 不讲代价的推荐不可信
维护成本是最终裁决 一年后修不修得动,比什么都重要
懂"为什么"才算懂 用 6 维度拷问、追问取舍,把每个项目变成一次升级
动钱和动别人隐私,先找人 这两条红线别独自硬上

Read the full file on GitHub · 138 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 138 lines · 212 tokens per session scan A dc0c874cf478

Subscribe to this mod's changes

vibe-coding-survival is a skill published in the GitHub repository Junliu1066/vibe-coding-kit (169 stars, last pushed 2mo ago), licensed MIT. It adds 212 tokens to every session and 2,309 once invoked, about $0.0011 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

state

Use when the user says 'update state', 'project state', 'where was I', or at session start to load current context.

cwinvestments/memstack · 29 tokens

project-butler

Project memory workflow for init/upgrade, profile-aware setup, end session, normal/full close, file organization, document archiving, language switching, versioned update logs, rule review, status, wiki sync, and context recovery. Use for /project-butler, setup/初始化, foundation setup, profile setup, end session/收工…

JamesShi96/project-butler · 133 tokens

no-code-app

Use when building an app on a no-code/low-code platform (Bubble, Softr, Glide over Airtable or Xano) — picking the platform, modeling the data, keeping usage-metered cost predictable, and planning the exit before lock-in. NOT a hand-written coded app (that is nextjs), NOT wiring SaaS tools together with no app UI…

ericrisco/rsc-harness · 87 tokens

n8n

Use when operating a live n8n instance programmatically — its REST API ({host}/api/v1, X-N8N-API-KEY) or the n8n-mcp server — to create, validate, test, activate, update, delete workflows and read executions on self-host or n8n.cloud. NOT designing the flow or its importable JSON (that is automation-flows), NOT…

ericrisco/rsc-harness · 99 tokens

register-project

Register an existing project in memory. Use when starting work on a new repo or when a project needs its own context file. Triggers on: 'register project', 'add project to memory', 'track this project', 'create project file'.

faizkhairi/claude-code-blueprint · 52 tokens

backlog-memory

One skill for a backlog project's persistent memory. It does two jobs — learn (load the project's tasks, plans, docs, and memory into the session) and store (synthesize the project's state into persistent memory entries). When invoked without a mode it auto-picks: learn at the start of a fresh session, store after…

mazen160/backlog · 83 tokens