dsh-project-handbook

让模型写一份项目交接文档，最常见的结果是措辞通顺、看起来专业，却经不起追问：部署流程哪一行代码能证明？业务规则是猜的还是真实存在的？新人拿到手后无从分辨哪些可以依赖、哪些需要找人来确认。dsh-project-handbook 把这件事拆成三个环节——确定性扫描、有据写作、严格质量门——让输出文档中每一个论断都附带代码路径或可复现命令作为证据，仓库本身无法回答的问题则显式标注为待确认项，而非编造看似合理的叙述。

核心机制是先跑一遍 project-inventory.mjs，对仓库做确定性盘点：语言、框架信号、CI 任务与命令、部署产物、环境变量名、迁移文件、入口点、测试布局、Git 历史与主要作者、技术债标记、疑似凭证文件，并预生成一份待确认缺口清单。写作阶段，按技术栈（Java/Spring、Go、Python、Node/TypeScript、前端、数据与 AI、遗留运维）加载对应的侦察手册，告诉代理该打开哪些文件、提取哪些事实。交付前，check-handbook.mjs 作为硬性质量门，拦截缺失章节、占位符、推测性措辞、无引用的徽章、路径不存在、链接无法解析、清单中不存在的脚本、粘贴的密钥、与盘点结果矛盾的论断。整个过程只读，不打开凭证、不构建、不部署、不提交。

适合需要交出项目的技术负责人、正在 onboarding 的新工程师，以及任何需要一份可追溯、可验收、新人第一周就能直接上手的项目文档的团队。