对比 superpowers 与 grill-with-docs 生成的文档

发布日期

2026年9月4日

superpowers 生成的文档很鸡肋

Superpowers Skill 技能会产生设计（specs）和执行（plans）文档在目录docs/superpowers下。 刚开始我会提交specs文档到git仓库。后来发现随着开发不断进行，产品不断迭代，这些文档很容易变的过期，与最新的代码不一致。而agent分不清文档是否过期，出现了agent debug bug时，误把过期文档内容当成标准，发现不一致就按文档进行修改了。

这让我不得不考虑将这些文档从git中删除。如果你还想保留这些文档，又不想其影响到agent，可以在目录doc/superpowers下新建 AGENTS.md 文件:

本目录（`doc/superpowers`）下是已存档的文档。其内容可能已过期，请将其忽略。

grill-with-docs 将生成的文档进行了合适的分类

mattpocock skills会生成的 CONTEXT.md和ADR文件。

• CONTEXT.md的内容为领域词汇，即领域驱动设计中所提到的UBIQUITOUS LANGUAGE。用于避免与AI的沟通误会，提高沟通效率。
• ADR文件是记录关键架构决策的文档。每个文档会内会标记其状态（status）。当架构决策发生变化后，skill会生成新的ADR文档，并修改旧文档的状态，标记其已经被新的文档取代。

to-spec,to-ticket 生成的短时文档存放在外部issues跟踪系统。

这套skills事实上将其生成文档分成了2类：

1. 持续有价值的文档存储于git中，
2. 短时有意义的工作跟踪文档、执行计划文档存储于issues跟踪系统。