你有没有过
用 AI(Claude Code / Cursor 之类)三两下做完一个产品,过段时间想加新功能,打开项目却懵了:文档当初放哪?这块为什么这么设计?翻半天找不到,最后只能把整个项目重新喂给 AI 让它再分析一遍。

AI 写代码飞快,但它不记事。 每次都从零开始,你也跟着重灌上下文。

问题根源:每个项目都"各搭各的"

根子是:每个项目的目录、文档结构都不一样,AI 每次都自由发挥。

结构不统一 → 你找不到文档 → AI 也找不到 → 只能重新分析 → 上下文反复重灌。

要破,就反过来:给 AI 立规矩——固定结构、固定流程、固定文档位置。

解决思路:看板管进度,文档管知识

灵基把两类信息严格分家:

放哪 装什么
进度 / 计划 / 过程 看板(灵计一动) 任务拆分、完成状态、踩坑 / 决策笔记
长期知识 仓库内 Markdown 需求、架构、设计、上线快照

为什么进度不写进文档?文档里的待办 / 时间线立刻过时、和代码脱节。进度是活的,交给看板:AI 把需求拆成可勾选的任务大纲,边做边勾、边记笔记。

灵基长什么样

clone 下来,目录结构是固定的:

你的项目/
├── README.md  CLAUDE.md  CHANGELOG.md
└── docs/
    ├── 开发流程SOP.md   ← 元规范,AI 先读这份
    ├── 架构总览.md  设计规范.md  部署手册.md  踩坑记录.md
    └── 功能/
        ├── _模板/      ← 新功能复制此目录
        └── NN-功能名/  每个功能一个目录

根目录自带 CLAUDE.md,AI 进项目自动读规则——什么时候建文档、放哪、进度记看板,全写死。

工作流:从一句话到上线

你说一句想法,AI 按固定阶段走:

需求 → 调研 → 设计 → 实现 → 测试 → 发布

关键点:每个阶段做完停下等你确认,不是放它一口气乱跑——你始终掌方向盘。

真正省事的在下一次:再加功能时,AI 自己去读之前写好的设计文档接着做,不用你把项目从头讲一遍。 结构统一它找得到,进度在看板它接得住。

怎么用

  1. GitHub 上 Use this template,或 clone keaipiao/lingbase
  2. 配好灵计一动看板(根目录 .lingji + MCP)
  3. 开新功能:让 AI 读 docs/开发流程SOP.md,按阶段走

开源 & 链接

  • 开源免费、MIT 协议
  • GitHub:https://github.com/keaipiao/lingbase

受够了每次重灌上下文、回头找不到文档?欢迎试试,点个 star ⭐

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐