让 AI 不再按过期文档写代码:AgentLockDoc 开源了

AI 编程越来越强,但新的问题也越来越明显:AI 很容易读到过期 README、把计划当事实、搞不清当前阶段范围,或者改了代码却忘了同步文档。

我开源了 AgentLockDoc,一套为 AI-assisted development 设计的双语项目文档模板。它的目标不是让文档变多,而是让 AI 和人类始终站在同一个工程事实面上工作。

AgentLockDoc 的核心结构包括:

  • AGENTS.md:AI 的项目总入口,告诉它先读什么、不要读什么
  • SESSION.md:当前项目事实快照,只记录被路径或命令验证过的代码现实
  • feature-registry:功能范围、阶段、状态、权威文档、代码入口和验证证据
  • doc-code-map:从代码路径反查应该同步哪些权威文档
  • conventions:统一 Status / Track / Risk / front-matter / 命名规则
  • profiles:针对 Agent Platform、CLI Tool、Web SaaS、Library / SDK、Software Automation 的裁剪建议
  • validate-docs:零依赖轻量自检脚本

它提供中文和英文两套完整模板:

  • templates/zh-CN
  • templates/en-US

使用方式很简单:

复制代码
cp -R templates/zh-CN/. /path/to/your-project/
cd /path/to/your-project
node scripts/validate-docs.mjs

英文项目可以复制 templates/en-US

如果你正在用 Copilot、Claude、Cursor、Codex、Aider 或任何 coding agent 进行长期开发,AgentLockDoc 也许能帮你减少 AI 跨会话失忆和文档漂移的问题。

GitHub: https://github.com/yjfkpyu/AgentLock

gitee: https://gitee.com/corlink/agent-lock

如果这个项目对你有用,欢迎 star,让更多开发者看到它。

相关推荐
aneasystone本尊1 分钟前
学习大模型推理的批处理:Continuous Batching
人工智能
IT_陈寒5 分钟前
Vue的响应式让我加班到凌晨,问题竟出在这个不起眼的地方
前端·人工智能·后端
和裕7 分钟前
平口开槽箱 vs 飞机盒 vs 扣底盒:自动化、展示效果与成本核心区别
大数据·运维·网络·人工智能·算法·自动化
维基框架12 分钟前
坊间传闻 OpenAI 将要发布GPT-6 Sol 模型
人工智能·pytorch·python
AgentMaster13 分钟前
从售前到售后全链路覆盖:智能客服在企业 5 大场景的落地实践与工具选型
大数据·人工智能·算法
ai小陈13 分钟前
GPU服务器租用安全配置实战:SSH密钥与端口最小化开放
服务器·人工智能·深度学习·安全·ai·gpu算力
万物智能信息科技16 分钟前
硬件看门狗MAX6369设置—【万物智能之开源鸿蒙OpenHarmony系统实战开发系列教程】
人工智能·华为·开源·harmonyos·鸿蒙
三掌柜66621 分钟前
22秒攻击窗口下的防御重构:AI Threat Defense 与 Agent 安全护栏实践
人工智能·安全
七牛云行业应用23 分钟前
WorkBuddy自定义模型失败怎么办?从接口鉴权到协议兼容的完整排查
人工智能·agent·ai编程
宸津-代码粉碎机27 分钟前
Java面试核心:JVM三大GC垃圾回收算法原理与生产场景落地分析
java·大数据·人工智能·python·spring