OpenLogos 定义标准, RunLogos 让标准落地。
OpenLogos 是一套免费的开源 AI 工程方法论。它将 40 余年经过验证的实践——BDD、TDD、DDD、Stage-Gate——编码为可与任何 AI 编程工具配合使用的 AI 可执行 Skills。RunLogos 是让方法论产出的每个产物都能落地的专业桌面应用。

一套编码为 Markdown Skills 的结构化 AI 工程方法论。可与任何 AI 编程工具独立使用——Claude Code、Cursor、OpenCode、GitHub Copilot 等。
OpenLogos 的最佳实践实现。可视化、编辑、编排和调试方法论产出的每个产物——全部集成在一个原生桌面应用中。
OpenLogos 将 Why → What → How 进阶流程编码为 AI 可执行的 Skills。每一层都从前一层派生——从需求到通过测试,产生完全可追溯的链条。
OpenLogos 的完整工作流——从意图到验证通过的代码,再到变更可控的迭代。每一步都产出一份具体产物,RunLogos 负责渲染、编辑与运行它们。这里是方法论的全貌;RunLogos 是让它落地的工作台。
描述你的意图,Skills 撰写规格文档
你说出想构建什么。内置的需求 Skill——预装了软件工程知识——引导你完成结构化对话:目标、用户痛点、场景、验收标准。对话结束后,一份完整的需求文档就绪。无需填写模板,无需记忆字段。

设计 Skill 将规格转化为原型
设计 Skill 读取你的需求并生成轻量级 HTML 原型。与规格文档并排预览,添加内联注释请求修改,在 AI 编写任何业务逻辑之前确认交互模型正确。在这里发现的误解代价为零。

场景 Skill 映射每个流程和边界情况
场景 Skill 读取你的产品设计,为每个用户流程生成时序图——哪个角色调用哪个 API、以什么顺序、有什么边界情况。场景是规格链的骨干:每个下游产物——API 契约、数据库 Schema、测试用例——都从中派生。没有场景就没有可追溯性。

API Skill 从场景派生每个契约
API Skill 读取你的场景图并生成完整的 OpenAPI 规格。每个端点都追溯到一个场景步骤——AI 不是猜测接口,而是读取契约。可视化编辑器让你在编写任何代码之前进行审查和完善。

Schema Skill 从 API 派生数据模型
Schema Skill 读取你的 API 契约并派生数据模型。可视化定义表结构——SQLite、PostgreSQL 或 MySQL——并导出 DDL。Schema 不是孤立设计的:它是从 API 需要存储和检索的内容推导出来的。

测试 Skill 在代码之前编写每个用例
测试 Skill 读取你的场景并生成单元和集成测试用例。在可视化流程构建器中串联多步骤 API 场景,针对实际服务器运行,并断言每个响应。测试在代码之前编写——因此验收标准在 AI 生成任何内容之前就已锁定。

AI 读取完整规格链,然后编写代码
一次性将完整规格链交给 AI:需求、原型、场景、API 契约、数据库 Schema、测试用例。因为没有任何缺失,输出是准确的——没有幻觉端点,没有猜测的表名,没有遗漏的边界情况。代码是针对契约生成的,而不是对话。

每个需求都追溯到一个通过的测试
运行 openlogos verify,获得完整的可追溯性报告——每个需求追溯到每个测试用例,包含通过率、覆盖率和门控结果。不只是"测试通过"。第 1 阶段的每个验收标准都有据可查。带着证明发布。

每次变更从提案开始,而不是提交
上线后,每次功能变更或错误修复都从 Delta 提案开始——而不是直接编辑代码。描述变更内容和原因,识别受影响的场景、API 和数据库表,让 AI 在触碰代码之前通过规格链传播变更。历史记录始终完整。

每个项目经历三个层次。需求先于设计;设计先于代码。当上下文完全定义时,AI 永远不会猜测。
单个场景 ID 贯穿所有阶段。测试用例在代码生成之前设计。openlogos verify 生成三层可追溯性报告。
每个决策都存在于 Markdown 文件中。相同的文档 → 相同的上下文 → 一致的 AI 输出。可审查、可复现,并在整个团队中累积。
AGENTS.md 自动检测当前阶段,加载正确的 Skill,并执行"没有设计文档就不写代码"等规则。AI 承担繁重工作;你保持控制。
OpenLogos 不是从零发明的新框架——它将成熟的软件工程方法论映射到 AI 原生执行上。
第 1 阶段 GIVEN/WHEN/THEN 验收标准
第 3 阶段步骤 3 测试优先设计,openlogos verify
架构、场景建模、统一语言
三层进阶门控,Gate 3.5
文档即上下文,logos/ 目录结构
AI Skills(SKILL.md),AGENTS.md 自动检测
OpenLogos 免费,今天就可以与任何 AI 编程工具配合使用。RunLogos 添加了可视化层,让方法论产出的每个产物更易于审查、编辑和执行。