project-ai-docs
在终端中运行以下命令:
dsh plugin install igugyj/project-ai-docs
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 终端中执行 dsh plugin install igugyj/project-ai-docs 即可安装本插件,源码地址为 https://github.com/igugyj/project-ai-docs 。
插件介绍
用 AI agent 做项目开发,最隐蔽的痛点不是单次回答质量,而是跨会话的上下文涣散——新窗口一开,agent 不记得上轮做了什么架构决策,分不清哪条路径是实测过的、哪条只是猜测,知识全部散落在聊天记录里,换个会话就归零。
project-ai-docs 给每个项目建立一份 docs/.ai/ 认知库:index.md 是唯一入口和优先级路由表,文档按 core、modules、config、best-practices 四层组织并显式分配 token 预算;硬约束(禁止项)永远排在索引最顶部,先于一切技术信息出现。agent 会话先读索引再动手,按任务点读相关切片而非全量加载;任务完成后必须回写对应文档并在 changelog 台账记账,知识沉淀在文件里而非靠会话记忆。人机分离原则让 README 面向用户、docs/.ai 面向 agent,互不干扰。只写实测路径、版本和命令,不写猜测,保证每条事实可验证。
适合日常使用 Claude Code、Codex、DSH 等 agent 宿主做项目开发的个人和团队,尤其是多模块、长周期、需要跨会话保持一致项目认知的项目。
使用场景
- 新会话开始时 agent 读取 index 与 changelog 快速恢复项目上下文
- 多模块项目中按任务点读相关文档切片,避免全量加载浪费 token
- 任务完成后回写对应文档并记录 changelog,确保知识跨会话沉淀
适合人员
- 日常使用 Claude Code、Codex、DSH 等 agent 宿主做项目开发的开发者
- 维护多模块、长周期项目,需要跨会话保持项目一致认知的团队
- 希望用结构化文档替代会话记忆、沉淀项目知识的独立开发者