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

相关推荐
loulanyue_1 分钟前
体验的Scaling时刻:读淘天首席科学家郑波2026云栖演讲
人工智能·计算机视觉·大模型·多模态
FII工业富联科技服务6 分钟前
2026年AI技术发展趋势分析:从模型能力突破到工业AI的真实应用
大数据·人工智能·深度学习·机器学习·制造·ai智能体·agentic ai
还卿一钵无情泪7 分钟前
Docker 部署Unsloth 绕开环境配置难题
运维·人工智能·docker·ai·容器·nlp·干货
johnsong23 分钟前
AI前沿日报 2026-10-07:信任崩塌
人工智能
菩提树下的凡夫37 分钟前
多线程是加载一个复用推理模型还是用多个独立的推理模型
人工智能·深度学习
冯一川44 分钟前
使用 Python 实现支持多轮对话的 CLI 聊天机器人(基于 Ollama)
人工智能
武子康1 小时前
LingBot-Video 怎么选推理路径?8 步 DMD 不等于小显存
人工智能·后端
Febrie1 小时前
Codex插件推荐:Local Figma Agent MCP,不购买付费套餐,也能让 Agent 读懂并修改Figma设计稿
人工智能
edtoplort1 小时前
OpenAI紧急叫停GPT-6.1 Astra训练,奥尔特曼为何踩刹车
人工智能·gpt·算法
打工仔折腾 AI1 小时前
Docker镜像分层与卷挂载到底怎么工作:一次文件系统层面的实测分析
运维·人工智能·后端·python·docker·容器·性能优化