跳转到内容

规格总览

OpenLogos 规格是所有 Skill、CLI 命令和 AI 指令文件都必须遵循的权威规则。它们定义了开发工作流、项目结构、文件格式以及平台集成机制。

规格分为三类:

约束 OpenLogos 项目推进方式的核心规则:

规格描述
工作流三层推进模型(WHY → WHAT → HOW)、场景串联、阶段检测、质量关卡
变更管理Delta 变更提案、影响分析、合并工作流与归档
Flow 规范可编排研发流程的数据模型:子流程、节点、门禁、循环、overlay
切片规划merge 之后如何规划 [code] 切片
PreToolUse Guard写入门禁:保护对象(版本控制内容)、事前判定、执行后检查与保护范围命令

项目布局、配置文件和数据格式的约定:

规格描述
项目结构标准目录布局、文件命名约定、logos.config.json schema
目录约定详细的目录结构与文件组织规则
模块命名约定多模块项目的模块前缀命名规则
logos-project.yamlAI 协作索引文件——schema、字段定义与示例
AGENTS.mdAI 指令文件——内容结构、生成规则、多平台适配
测试结果格式跨框架测试结果上报的 JSONL 格式、reporter 代码模板
tasks.md 格式变更提案任务文件的结构化格式——章节标记与状态检测
TEST_SLICE_MANIFEST由 openlogos slice plan 写出、供 verify 读取的 [code] 切片机读清单
SQL 注释约定SQLite DDL 元数据注解的结构化注释格式
环境登记表logos/environments.yaml 字段、DEPLOY_DONE 格式、本机部署账本、smoke 环境证据、部署执行、晋级与审批门禁
CLI JSON 输出CLI 命令的结构化 JSON 输出规格(status、verify、smoke、detect、env、deploy、approve)

针对特定 AI 编码工具的集成规格:

规格描述
OpenCode 插件OpenCode 原生插件——命令桥接、hook 注入、双模式架构
Codex 插件Codex CLI 原生插件——SessionStart hook、阶段上下文注入、双模式架构
Cursor 插件Cursor 集成:.cursor/skills/ 原生 Skills、.cursor/hooks.json 托管条目、带 afterShellExecution 事后检查的部分强度 guard
ZCode 插件位于 .zcode/plugins/openlogos/ 的 ZCode 原生插件:Skills、命令、agents、SessionStart 与 PreToolUse hooks
Qoder 插件位于 .qoder/plugins/openlogos/ 的 Qoder CLI 原生插件:Skills、命令、agents、SessionStart 与 PreToolUse hooks
WorkBuddy 插件位于 .workbuddy/plugins/openlogos/ 的 WorkBuddy 原生插件:Skills、命令、agents、SessionStart 与 PreToolUse hooks;不触碰原生记忆