penstic123-code

Vibe Friend — AI skill for Claude Code

AI community

Keep an AI coding project's requirements and rules in one tree.

How to install Vibe Friend

This entry records only its repository, not the path inside it, so there is no exact command to give. Open penstic123-code/Vibe-Friend and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Vibe Friend does

Keep an AI coding project's requirements and rules in one tree. Claude Code and Codex get only the rules for the files they touch, and a background recorder keeps the tree up to date. VS Code extension. 中文 / English.

Alternatives in AI

README

Vibe Friend · 需求树 ReqTree

和 AI 一起做项目,"我们之前不是定好了吗"这句话,你大概已经说过很多遍了。需求树就是为这句话做的。它把你在聊天里定下的需求和规则收进一棵树:AI 改到哪个文件,就把那部分规则递给它;你随口说的长期要求,后台会帮你记下来,记错了点一下撤销。

给 [Claude Code](https://claude.com/claude-code) 和 [OpenAI Codex](https://developers.openai.com/codex) 用,带一个 VS Code 插件。[English](README.en.md) | **中文**

![在对话里说一句规则,它出现在树上,再点撤销](docs/images/demo.gif)

在对话里说一句"以后每章结尾都加一道思考题",这一轮结束,它就出现在树上。记错了,点一下撤销。

你是不是也遇到过

和 AI 一起做一个长期项目,几周下来,同一条规则会长出好几个分身:聊天里说过一遍,CLAUDE.md 里写过一遍,AI 的记忆里存过一遍,项目文档里又抄了一遍。后来你改了主意,只改了其中一处,另外三处还在坚持旧说法。

需求也差不多。一个功能改了又改,三周前定的方案被推翻了两次,做到后来,你自己都说不清项目现在是什么样:哪些做完了,哪些还在做,哪条规则才是最新的。

AI 那边也不轻松。对话一长、上下文一压缩,早先定好的"段落不超过 4 行"就没了;派出去的子 agent 只拿到一半规则;你问它"我们之前怎么定的",它从三份互相打架的文档里挑一份给你。

![规则散在好几个地方](docs/images/pain.png)

我给自己做了几个月的课程项目做过一次体检:21 份规则文档、8 万多字,查出 237 处重复、矛盾和过时。agent 并行数这件事,一份文档写"一次只开一个",另一份写"可以两三章并行";"三道检查"这一条,在不同文件里被抄了 15 遍。

它做什么

需求改了又改,现在到底是什么样? → 一棵树看全貌:做到哪一步、哪版规则在生效;谁改了什么都有记录,都能撤销
麻烦
需求改了又改,现在到底是什么样?
需求树
一棵树看全貌:做到哪一步、哪版规则在生效。谁改了什么都有记录,都能撤销
规则散在四处,不知道该听哪份的 → 所有规则住在一个文件里,每条只有一个位置
麻烦
规则散在四处,不知道该听哪份的
需求树
所有规则住在一个文件里,每条只有一个位置
差不多的规则加了一遍又一遍 → 记录员改写原来那条,不另起一条;记错了一键撤销
麻烦
差不多的规则加了一遍又一遍
需求树
记录员改写原来那条,不另起一条;记错了一键撤销
上下文一压缩,AI 就把规则忘了 → 规则交给 Claude Code 自己的机制,压缩以后、子 agent 里照样在
麻烦
上下文一压缩,AI 就把规则忘了
需求树
规则交给 Claude Code 自己的机制,压缩以后、子 agent 里照样在
所有规则一股脑塞进上下文 → 改到哪个文件,才带上那个需求的规则
麻烦
所有规则一股脑塞进上下文
需求树
改到哪个文件,才带上那个需求的规则