停止 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 工具完成每个开发阶段。
AI 读取 AGENTS.md，运行 openlogos init，搭建整个项目结构。
AI 检测到 Phase 1，加载 prd-writer Skill，引导你梳理痛点和场景，生成结构化需求文档。
AI 加载 api-designer Skill，读取时序图，生成 OpenAPI YAML 规格。
AI 先设计测试用例（测试先行！），再基于完整上下文生成实现代码。
运行 openlogos verify —— 三层追溯检查通过率、覆盖度和验收条件。
一次授权，变更自己跑完。
flow 引擎把整个变更生命周期建模为声明式状态机。运行一次
openlogos next --auto，AI driver 便走完整条链路——只在硬安全线前停下。
半自动（默认）保留每一个人类确认点——merge、verify、部署、smoke、archive、push。全自动（--auto）是一次性、run-scoped 的 standing 授权：自动放行可跳过的门，代码转绿后自动执行 verify / smoke / archive / push，并把每次放行追加到 GATE_AUTO_PASSED 审计轨迹。
implement 段对代码切片循环，直到测试转绿。若达迭代上限仍未收敛，升级为不可跳过的 loop-exhausted 门。任何模式——即便 --auto——都绝不自动放行未通过测试的代码。
适配你的 AI 工具
Skills 是平台无关的 Markdown 文件。任何能读取项目文件的 AI 工具都可以使用 OpenLogos。
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