【开源 Skill】像 DeepSeek 团队一样维护项目

开源推广声明

本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：

- 我的帖子已经打上 开源推广 标签： 是

- 我的开源项目完整开源，无未开源部分： 是

- 我的开源项目已链接认可 LINUX DO 社区： 是

- 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是

- 以上选择我承诺是永久有效的，接受社区和佬友监督： 是

以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出

相信做开发的佬友们都有经历过这样血压飙升的时刻：花了很长时间和AI 讨论写了一段设计非常复杂的代码逻辑，虽然输出的代码看起来不够优雅，但经过多方权衡和重重踩坑和验证之后，在线上稳定运行了很长的一段时间。结果当下次需求 AI 写代码的时候，就会认为这个地方代码不够优雅，如果你稍不留神，可能就帮你“优化”了。

那么 DeepSeek 团队是怎么避免这个问题的呢？在深入研究 DeepSeekHarness 的源码之后，我们可以看到他们在项目中维护了大量的工程决策文档。在每次 PR 中都会伴随着大量的原有文档的修改以及新增的决策。

这套 notes把代码本身写不出来的信息 —— 当初为什么这么设计、舍弃过哪些方案，跟代码放在一起同步提交。再在函数入口留下提示标记，避免新的 AI 因为换对话就忘掉历史上下文，上来就乱重构，把之前踩过的坑又重踩一遍。

我把 DeepSeek 的这套工程实践做成了一个开箱即用的 skill，可以直接一行代码装进我们的项目中，让我们也能像 DeepSeek 那样维护好项目的文档。

项目链接如下，如果觉得好用，可以给个 star～：

github.com

GitHub - czm15053/write-notes-like-deepseek: 像 DeepSeek 团队一样沉淀 Agent...

像 DeepSeek 团队一样沉淀 Agent Notes——决策、取舍与验证一处留痕，半年后仍可追溯。可叠加到任何仓库

另外项目中还做了一套可以直接展示项目文档进度的网页看板，下面是一个基于 DeepSeek Harness notes 的完整演示demo，欢迎佬们体验一下：

itchy-apricot-heiz1yty.edgeone.dev

工程决策看板