convez.ai
MCP ServerDesenvolvimento WebIntermediário
keaipiao

Lingbase: Scaffold de Desenvolvimento AI Estruturado

keaipiao/lingbase

SOP estruturado para AI dev: docs padronizadas + workflow kanban integrado

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server que fornece um scaffold padronizado para desenvolvimento de aplicações com IA, estruturando documentação em fases de desenvolvimento (iniciação → design → arquitetura → implementação → testes → deploy) e integrando fluxo de trabalho com kanban externo. Elimina a necessidade de AI 'improvisar' estruturas de projeto a cada vez, garantindo documentação consistente e repositório organizado.

Instalação

$npx convez-ai keaipiao/lingbase

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Padronizar fluxo de desenvolvimento de aplicações com IA (Claude Code, Cursor, etc)
  • Manter documentação estruturada e incremental durante desenvolvimentos guiados por IA
  • Gerenciar múltiplas funcionalidades em projeto com rastreamento de progresso centralizado

Veredito

Solução pragmática para independentes e pequenos times usando IA para desenvolvimento: elimina caos de estruturas ad-hoc e força consistência. Melhor para quem já usa Claude Code ou MCP servers regularmente e quer disciplina em projeto repetível; documentação em chinês é barreira para não-falantes.

README

A tradução para o português deste README ainda está na fila.

灵基 · lingbase

独立开发者的 AI 编程工作流脚手架 —— 让 AI 编程工具按标准化流程自动帮你做产品、做功能,配套 灵计一动 看板边做边维护进度。

克隆它起新项目,AI 就按固定结构走,不再每次自由发挥、另起一套文档。任何能读项目规则文件 + 连 MCP 的 AI 工具都能用(Claude Code 开箱即用、其它工具一行映射,详见下文)。

灵计一动看板:AI 边做边勾计划


解决什么问题

AI 编码工具每次都按自己的想法新建文档结构 —— 文档位置飘忽、回头找不到、风格各不相同。换个项目、过几个月回来,全得重新摸。

灵基把「做哪些文档、放哪里、什么时候写、按什么顺序推进」固定下来:AI 只复制模板填空、按 SOP 推进,不自由发挥。


能让 AI 自动做什么

  • 🤖 按标准化六阶段开发:立项 → UI 设计 → 技术方案 → 实现 → 测试 → 发布归档。每阶段都有明确产出位置和完成条件,关键节点停下等你确认,不会跑偏。
  • 📝 自动写 / 维护项目文档:架构总览、设计规范、部署手册、踩坑记录 —— 随开发增量沉淀,不是事后补。
  • 📋 自动管理灵计一动看板:拆计划、勾进度、记决策 / 踩坑 / 验证笔记,全程由 AI 边做边维护,计划和进度永不写进文档。
  • 🎯 一个里程碑 = 一条灵感:每条里程碑灵感的计划就是它的六阶段;一个产品 = 一串里程碑灵感。新产品第一条是打地基(架构 / 设计规范 / 脚手架),之后每个功能各一条灵感、走一遍六阶段流水线。

快速开始·三步

  1. 拿到模板 —— 在 GitHub 点「Use this template」起新仓库,或 clone 本仓库。
  2. 接入灵计一动 MCP —— 注册账号并配好 MCP(见 lingji1dong.com)。
  3. 打开你的 AI 编码工具,说出你的想法 —— 比如「我想做个 XX 产品」(非 Claude Code 工具先按下方说明把 CLAUDE.md 映射到其入口文件)。AI 会读 CLAUDE.md 自动接好看板、和你聊清产品、把想法拆成几个里程碑(各记一条灵感)→ 从打地基(架构 / 设计规范 / 脚手架)开始,逐个推进。

支持任何能读项目规则文件 + 连接 MCP 的 AI 编码工具。

  • Claude Code:开箱即用,自动读 CLAUDE.md。
  • 其他工具(Cursor / Copilot / Codex / Aider 等):把 CLAUDE.md 复制或软链到对应入口文件(如 .cursorrules / .github/copilot-instructions.md / AGENTS.md / CONVENTIONS.md),即可同样使用。

AI 协作规则在根目录 CLAUDE.md,开箱即用——AI 进项目先读它。


这套工作流怎么运作:看板管进度,文档管知识

两类信息严格分家 —— 这是整套工作流的地基:

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

为什么进度不写进文档? 文档里的待办 / 时间线会立刻过时、和代码脱节、没人维护。进度是活的,交给灵计一动看板:写计划大纲 → 边做边勾 → 笔记成日志,配套 MCP 让 AI 直接读写。

→ 计划和进度永远只在看板,文档只留沉淀下来的知识。两边不重复,各管一摊。


目录结构

你的项目/
├── README.md        ← 这份(起项目后可换成你应用的介绍)
├── CLAUDE.md        ← AI 协作规则(开箱即用,先读它)
├── CHANGELOG.md     ← 版本变更总账
└── docs/
    ├── 开发流程SOP.md   ← 开发流程元规范(里程碑模型 + 六阶段 + 横切动作)
    ├── 架构总览.md      技术栈 / 架构 / 数据模型 / 全局决策
    ├── 设计规范.md      前端设计系统(含 UI 出图三路线;无前端可不建)
    ├── 部署手册.md      从零冷启动
    ├── 踩坑记录.md      跨功能可复用坑
    ├── 资源/           项目级资源:logo / 品牌 / 全局原型
    └── 功能/
        ├── _模板/      ← 新功能复制此目录
        └── NN-功能名/  每个功能一个目录

docs/ 根只放项目级的「长期文档」,所有功能集中在 docs/功能/ 下,几十个功能也不乱。


文档导航

看什么去哪
开发流程怎么走docs/开发流程SOP.md
AI 协作规则CLAUDE.md
技术架构docs/架构总览.md
UI 设计规范 / 出图路线docs/设计规范.md
部署docs/部署手册.md
已知坑docs/踩坑记录.md
某个功能docs/功能/NN-功能名/{设计, 测试, 发布部署}.md

🛠 起项目后可按需替换本 README:把上面对灵基的介绍换成你应用的门面;下面的「目录结构 / 文档导航」对任何用本套件的项目都成立,保留即可。

License

MIT

Ver o original no GitHub

Bom para

Relacionados