让 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,让更多开发者看到它。

相关推荐
七牛开发者2 小时前
从 GLM 到 GPT,HarnessPro 如何用 RSI 降低 Agent 成本
人工智能·gpt·agent·harness·rsi
跨境卫士-小汪2 小时前
TikTokShop欧洲商品接口架构调整跨境技术团队需要做好哪些准备
大数据·人工智能·新媒体运营·跨境电商·跨境·营销策略
康小汪3 小时前
AI 写 Vue 总写成同一个味道:给它装 Skills,装的不是知识是边界
前端·vue.js·人工智能·ai编程·最佳实践
收放扳机3 小时前
多机连线(In-Line)场景下,收放板机“缓存工位”的容量与架构选型参考
人工智能·科技·自动化·制造·pcb工艺
武天旭4 小时前
AI安全--AI大模型的后门攻击检测与防御
人工智能·深度学习·安全·机器学习
智能运维指南4 小时前
研制过程“两张皮“怎么破:研制一体化支撑平台的定位、能力边界与落地前提
java·前端·人工智能·嘉为蓝鲸
人工智能AI技术4 小时前
DeepInfer开源炸场!别再妄想个人电脑跑满血DeepSeek
人工智能
深蓝电商API4 小时前
用AI生成拟人行为:让鼠标轨迹更“有人味”
人工智能·爬虫
znnnk4 小时前
数据库被AI“重写”:2026,从CPU中心走向GPU中心
数据库·人工智能·oracle
深蓝AI4 小时前
网站正在对 AI Agent 集体关门:亚马逊封锁 Muse、银行拒绝登录,开发者怎么活下去
人工智能