为 vibe coding 设计的 issue 追踪方案: dot-issues Skill

https://github.com/darwintree/dot-issues

Issues that live in your repo — plain Markdown, built for agents.

特点

• 不依赖 GitHub Issues ，完全本地化
• 为 AI agent 集成设计
• 运行前可直接审计全部源码

安装为 skill

npx skills add https://github.com/darwintree/dot-issues --skill dot-issues

想法来自于需求。

我尝试按照 harness engineering 实践了一段时间，一些发现

1. 相比传统工程流程，vibe coding 的开发流程中会遇到更多 issue 。直觉上是代码质量本身就会更差。结构上是在于，坏的设计诞生后会传播并扩大影响。
2. harness engineering 一个核心是文档管理，让 ai 知道发生了什么。
3. 发现的 issue ，可能并不适合在当下解决，但还是需要留档。

换言之，对于 vibe coding 来说，** issue 管理 ** 这件事情是非常有必要的。问题在于，为什么要新写一套而不用 github issues 。

1. 不用 github 也能用
2. issue 可能是和代码绑定的，并且需要留档：ai 在某个分支写了一堆能用的代码，但可能有一些缺陷，当下解决反而会扩大影响，相当于 ai 提交了一个不完美的方案，并说明问题以待日后解决。对我来说这个情景很常见，相当于是将“新 feature”和“重构”拆分。
3. ai 交互友好：当 ai 通过 grep 等工具搜索代码时，就有可能直接命中对应的 issue ，通过阅读上下文，ai 可以容易地知道现状，以及该如何处理

如果你也有对应的需求可以直接让 ai 用这个 skill 。skill 脚本没有外部依赖，可以让 ai 直接审计，确保没有安全问题。有什么建议也可以直接提 pr