开源 · Apache 2.0
停止 Vibe Coding。
开始正确构建。
OpenLogos 是为 AI 时代打造的开源软件研发方法论。 它将 AI 编程工具从"碰运气"变为"精准工具" —— 基于四大核心原则。
npx @miniidealab/openlogos init my-project 问题
当今大多数 AI 编程是"Vibe Coding"
直接跳到写代码，祈祷 AI 能猜对。结果呢？歧义爆炸、黑盒堆积、项目在规模化时崩溃。
歧义爆炸
没有清晰的需求，AI 只能猜你想要什么。每次猜测都在累积不确定性。
黑盒堆积
AI 生成你不理解的代码。时间一长，你的代码库变成了不透明的黑盒。
无尽返工
没有规格说明就没有"完成"的定义。你永远在迭代，却永远无法收敛。
核心理念
让 AI 真正可靠的四大支柱
OpenLogos 建立在经过实战检验的软件工程理论之上，为 AI 时代重新编译。 每条原则相互增强。
工作流程
说一句话，AI 完成一切。
OpenLogos 将方法论编码为 AI Skills —— Markdown 文件自动引导你的 AI 工具完成每个开发阶段。
01
"帮我初始化一个新项目"
AI 读取 AGENTS.md，运行 openlogos init，搭建整个项目结构。
02
"帮我写需求文档"
AI 检测到 Phase 1，加载 prd-writer Skill，引导你梳理痛点和场景，生成结构化需求文档。
03
"设计这个场景的 API"
AI 加载 api-designer Skill，读取时序图，生成 OpenAPI YAML 规格。
04
"写测试用例并生成代码"
AI 先设计测试用例（测试先行！），再基于完整上下文生成实现代码。
05
"验收测试结果"
运行 openlogos verify —— 三层追溯检查通过率、覆盖度和验收条件。
兼容性
适配你的 AI 工具
Skills 是平台无关的 Markdown 文件。任何能读取项目文件的 AI 工具都可以使用 OpenLogos。
Claude Code
已支持 OpenCode
已支持 Cursor
已支持 GitHub Copilot
兼容 Windsurf
兼容 任意 AI 工具
通过 Markdown 快速上手
2 分钟启动
# 安装 CLI
$ npm install -g @miniidealab/openlogos
# 初始化项目
$ openlogos init my-project
✓ Created logos/logos.config.json
✓ Created logos/logos-project.yaml
✓ Created AGENTS.md
✓ 项目 "my-project" 初始化完成
# 打开 AI 工具开始开发
$ cd my-project && claude