AI 编码项目时间一长，结构和文档越来越乱，有什么好用的 project clean / code clean skill 推荐？

[bingoAI]

背景：这一年多个人和公司的项目基本全用 AI CLI agent （ Claude Code / Codex 这类）写，单次会话的质量还行，但项目时间一长，腐化问题非常明显：

1. 结构腐化：agent 倾向"就地新增"，几乎每个会话都可能造一份新的 utils / helpers / adapters ，重复实现越攒越多，到后期没人敢删；
2. 文档腐化：README 、DESIGN 、总结类 markdown 越写越多，大量内容互相矛盾或早已过期，而且 AI 还喜欢每次再生成一份新的；
3. 元数据腐化：AGENTS.md / CLAUDE.md 越来越长，规则开始互相打架，agent 反而不遵守；
4. 一次性产物散落：调试脚本、测试输出、临时报告混进源码目录。

我自己试过的：

• 规则层：AGENTS.md 里写死 Quality Pipeline （ Review → Verify → Simplify 三关全过才许 commit ）+ "不做超出任务需要的重构"。对单次会话有效，挡不住长期漂移；
• 流程层：装了 Matt Pocock 的 grill → to-spec → to-tickets → implement 主链，靠"先 spec 再动手"从源头减少乱长。有改善，但 spec / tickets 本身又开始堆积成新的混乱源；
• skill 层：code-review / clean-code / simplify / improve-codebase-architecture 这类清理和审查 skill 。能发现问题，但执行还是靠 agent 自觉；
• 工具层：JS/TS 用 Knip 、Python 用 Vulture 检测死代码，agent 验证后再删。这条最稳，但只解决 code clean ，解决不了结构 / 文档层面的腐化。

也读过 Anthropic 的 AI-native SDLC playbook （ intent → spec → plan → diff → PR 工件链 + skill/hook/eval 三层控制），思路很好，但明显是给有平台工程团队的组织设计的，个人开发者照抄成本太高。

想请教：

1. 长期跑 AI 编码的项目，结构 / 文档腐化你们是怎么治的？有没有固定的"项目定期体检"流程？
2. 有没有好用的产品开发 / 工程治理方向的 skill （ project clean / code clean ）推荐？ Claude Code 或通用 agent 的 skill 生态里有什么值得装的？
3. 文档生命周期管理有没有好方案？比如 spec / docs 过期自动归档、跟随代码同步更新之类。

[cgcs]

有趣的话题。在传统项目里，其实也有这类问题，只是项目迭代慢，可能是若干年甚至十来年。

现在 ai 堆代码太快，这个问题很快就冒出来了

[garlicerBx]

我经常时不时让 AI 整理一次，过期的文档丢在一个过期的文件夹中，产出一份最新最完整的结论文档在外层。但还是挺痛苦的，感觉效果不好

[zuokanyunqishi]

额,这个问题是我两月前探索的,,,,是有解法的...

[cgcs]

@zuokanyunqishi 说说，别卖关子