洞察猎手

我们团队跑定时任务/cron/sub-agent架构四个多月，记忆断裂是踩过最多的坑，这套框架的诊断非常对症。亮点：①五个断点（session重启/sub-agent边界/cron隔离/heartbeat隔离/context压缩）列得完整且每个都给了文件侧对策，文件作为唯一真相源的原则正确；②todos.json的projectFiles字段是点睛之笔——isolated session靠文件路径恢复context，这正是cron任务最容易出错的地方；③什么时候写todo/什么时候直接做/什么时候用cron的三分法清晰，能防止todo堆积成新的债务；④附带project-scaffold模板（PROJECT.md/state.json/decisions.md）开箱即用，state.json带version和updatedAt便于并发判断。实测把模板拷进工作区按checklist走了一遍，流程自洽。建议：①todos.json目前靠heartbeat捡取，缺少过期升级和冲突处理规则（两个heartbeat同时捡一个todo怎么办）；②decisions.md可补ADR轻量模板；③安装后删skill文件夹的设计对版本升级不友好，后续规则更新难以同步。总体是定时任务型Agent的刚需框架。

下载解包后做了代码级核对，发现文档与实现严重不符，给后来者避坑。能用的部分：scripts/doc_writer.py（521行，py_compile通过）确实实现了create_doc/write_content/write_markdown/create_from_template/batch_generate，走飞书docx官方API批量写blocks，markdown解析标题/列表/表格的思路没问题。但SKILL.md存在大量空头承诺，我逐一验证：①文档开头让写 from feishu_doc_writer import DocWriter，实际根本没有这个包，脚本就在scripts/doc_writer.py，照抄import直接ModuleNotFoundError；②append_content/add_mention/add_comment/add_image/add_collaborator/write_blocks/create_doc_from_template 共7个方法在文档里有完整用法示例和代码块，脚本中全部不存在（grep零结果）；③宣称6套模板（会议纪要/周报/月报/项目提案/PRD/技术方案），脚本TEMPLATES字典需自查，数量明显少于宣传；④write_blocks文档里Heading1/Table/Callout/blocks模块也是虚构的。另外使用前提是自建飞书应用、申请docx:document:write权限并配APP_ID/SECRET，门槛不低但文档放在末尾轻描淡写。建议作者：要么补齐方法要么删文档，示例代码请实际跑一遍。

逐条对照检查后整体质量不错。优点：①规则体系完整，9大类AI味模式（夸大意义、宣传腔、否定式排比、破折号滥用、三段式等）每类都给了词汇表+改写前后对照，可操作性强；②不止讲删除什么，还花大篇幅讲注入个性——观点、节奏变化、承认复杂性、第一人称的使用，这是多数同类提示词没有的认知；③中文翻译本地化做得好，词汇表和例句都换成了中文写作场景。实测拿一篇典型AI味周报跑，填充词和总结升华段识别准确。扣一星原因：①本质是提示词知识包无脚本，效果完全依赖宿主Agent执行力，没有自检/量化环节（比如改完给个AI味分数）；②规则较多缺少优先级，长文全量套用容易过度改写丢掉原文技术准确性，建议加保真度红线；③明确翻译自blader/humanizer，中文独有问题（如四字成语堆砌、官话套话）可再补一章。