dsh-llms-forge

AI agent 走进一个仓库时，最先寻找的文件往往是 llms.txt——一份专为机器阅读而写的结构化摘要。然而绝大多数 DeepSeek Harness 插件并没有这个文件：手写的容易随时间漂移、格式参差不齐，不写的则让 agent 只能靠猜测，效率大打折扣。

dsh-llms-forge 做的事情很直接：读取 package.json 和 README.md，确定性地产出一份 llms.txt。标题取包名，摘要取 description 或 README 首段，安装命令、许可证、主页、关键词、入口、CLI 等关键事实逐项收集，不凭空编造任何数据。默认只读、输出到 stdout，写盘和覆盖都需显式开启；退出码区分干净、警告和 IO 错误，方便直接接入 CI 做一致性校验。整个过程零运行时依赖，跑完即走，不会在环境里留下任何附加负担。

如果你维护一个 dsh 插件、希望仓库对 AI agent 友好，或者团队需要把 llms.txt 纳入流水线做定期校验，这个插件就是为此而生的。它不替代人工撰写的文档，只是让那份机器入口文件始终与包元数据保持诚实、可复现、可审计。