@miniidealab/openlogos 0.7.2 → 0.8.0

package/spec/logos-project.md

@@ -16,6 +16,8 @@
 |------|------|------|------|
 | `project` | object | 是 | 项目基本信息 |
 | `tech_stack` | object | 是 | 技术栈描述 |
+| `scenario_counter` | object | 否 | 全局场景编号计数器（多模块项目必填） |
+| `modules` | array | 否 | 模块注册表（多模块项目必填） |
 | `scenarios` | array | 否 | 场景清单（单一真相来源，Phase 3-1 前写入） |
 | `resource_index` | array | 是 | 资源索引列表 |
 | `conventions` | array | 否 | 项目约定 |
@@ -62,6 +64,27 @@
 | `mock-callback` | 编排中主动调用模拟回调端点 | 支付回调、Webhook |
 | `mock-service` | 使用本地 mock 服务替代 | OAuth Provider、第三方 API |
 
+### scenario_counter
+
+对象，维护全局场景编号计数器。多模块项目必填，确保不同模块的场景编号全局唯一、不重复。
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `next_id` | integer | 是 | 下一个场景的序号（整数），如 `19` 表示下一个场景从 `S19` 开始 |
+
+**使用规则**：AI 每次生成新场景前必须读取此字段取号，生成后立即将 `next_id` 加 1 并写回，严禁不同模块从 S01 重新开始编号。
+
+### modules
+
+数组，模块注册表。多模块项目必填，统一在此文件维护，不另建 `modules.yaml`。`openlogos init` 时自动写入 `core` 模块初始数据。
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `id` | string | 是 | 模块标识符，小写字母 + 连字符，如 `core`、`payment` |
+| `name` | string | 是 | 模块名称（中文或英文均可） |
+| `status` | string | 是 | 模块状态：`in-progress`（推进中）或 `stable`（已稳定） |
+| `loop_phase` | string\|null | 是 | 当前所处阶段（如 `api-design`、`scenario-modeling`）；`stable` 模块设为 `null` |
+
 ### resource_index
 
 数组，每个元素描述一个关键资源文件：
@@ -84,13 +107,13 @@
 | `id` | string | 是 | 场景唯一编号，格式为 `S` + 两位数字，如 `S01`、`S02` |
 | `name` | string | 是 | 场景名称（一句话描述） |
 
-**命名规则约定**（各阶段产出物通过 `SXX` 前缀与场景关联，无需在 yaml 中声明路径）：
+**命名规则约定**（各阶段产出物通过 `<module>-SXX` 前缀与场景关联，无需在 yaml 中声明路径）：
 
 | 阶段 | 产出物路径规则 | 示例 |
 |------|-------------|------|
-| Phase 3-1 场景建模 | `logos/resources/prd/3-technical-plan/2-scenario-implementation/SXX-*.md` | `S01-user-register.md` |
+| Phase 3-1 场景建模 | `logos/resources/prd/3-technical-plan/2-scenario-implementation/<module>-SXX-*.md` | `core-S01-user-register.md` |
 | Phase 3-2 API 设计 | `logos/resources/api/SXX-*.yaml` 或 `SXX-*.yml` | `S01-user-register.yaml` |
-| Phase 3-3a 测试用例 | `logos/resources/test/SXX-*.md` | `S01-test-cases.md` |
+| Phase 3-3a 测试用例 | `logos/resources/test/<module>-SXX-*.md` | `core-S01-test-cases.md` |
 
 **完成判断规则**：只有 `scenarios` 中每个 `id` 在对应阶段都存在匹配文件，该阶段才视为完成。若 `scenarios` 字段缺失，则降级为旧的"目录有文件即完成"逻辑（向后兼容）。
 
@@ -114,6 +137,19 @@ tech_stack:
   auth: "Supabase Auth"
   payment: "Paddle"
 
+scenario_counter:
+  next_id: 6
+
+modules:
+  - id: core
+    name: 核心功能
+    status: stable
+    loop_phase: null
+  - id: payment
+    name: 支付模块
+    status: in-progress
+    loop_phase: api-design
+
 external_dependencies:
   - name: "邮件服务"
     provider: "SendGrid"
@@ -132,9 +168,9 @@ external_dependencies:
     test_config: "POST /api/test/simulate-payment-callback"
 
 resource_index:
-  - path: logos/resources/prd/1-product-requirements/01-requirements.md
+  - path: logos/resources/prd/1-product-requirements/core-01-requirements.md
     desc: 产品核心需求文档。涉及产品定位、目标用户、功能需求时必读。
-  - path: logos/resources/prd/2-product-design/1-feature-specs/01-information-architecture.md
+  - path: logos/resources/prd/2-product-design/1-feature-specs/core-00-information-architecture.md
     desc: 信息架构文档。涉及页面结构、导航设计时必读。
   - path: logos/resources/api/auth.yaml
     desc: 认证相关 API 规格。涉及登录、注册、OAuth 接口设计时必读。

package/spec/module-naming-convention.md

@@ -0,0 +1,74 @@
+# 模块前缀命名规范
+
+> 版本：1.0.0
+>
+> 本文档定义 OpenLogos 多模块项目的文件命名规范。所有 Skill 生成文件时必须遵循此规范。
+
+## 核心原则：文件名即命名空间
+
+所有设计文档文件名统一遵循格式：
+
+```
+<module>-<序号或语义名>-<类型>.md
+```
+
+- **module**：模块标识符，小写字母 + 连字符，如 `core`、`user`、`payment`
+- 初始项目的默认模块统一使用 `core-` 前缀
+- 新模块开发时，直接在同一目录下创建带新模块前缀的文件，无需新建子目录
+
+## 各类文件命名规则
+
+| 文件类型 | 格式 | 示例 |
+|---------|------|------|
+| 需求文档 | `<module>-{序号}-{英文名}.md` | `core-01-requirements.md` |
+| 功能规格 | `<module>-{序号}-{英文名}.md` | `core-00-information-architecture.md` |
+| 页面设计 | `<module>-{序号}-{英文名}.md` | `core-01-cli-terminal.md` |
+| 架构文档 | `<module>-{序号}-{英文名}.md` | `core-01-architecture-overview.md`（全局唯一，始终在此文件上更新） |
+| 场景概览 | `<module>-00-scenario-overview.md` | `core-00-scenario-overview.md` |
+| 场景实现 | `<module>-SXX-{英文名}.md` | `core-S01-cli-init.md` |
+| 测试用例 | `<module>-SXX-test-cases.md` | `core-S01-test-cases.md` |
+
+## 场景编号全局唯一
+
+所有模块的场景编号共享一个全局递增序列（`S01`、`S02`...），由 `logos-project.yaml` 中的 `scenario_counter.next_id` 字段维护。
+
+**AI 行为约束**：
+1. 生成新场景前，必须读取 `logos-project.yaml` 的 `scenario_counter.next_id` 取号
+2. 生成后立即将 `next_id` 加 1 并写回
+3. 严禁不同模块从 S01 重新开始编号
+
+## 模块注册表
+
+模块统一在 `logos-project.yaml` 的 `modules[]` 中维护，不另建 `modules.yaml`。
+
+```yaml
+scenario_counter:
+  next_id: 19
+
+modules:
+  - id: core
+    name: 核心功能
+    status: stable
+    loop_phase: null
+  - id: payment
+    name: 支付模块
+    status: in-progress
+    loop_phase: api-design
+```
+
+## 多模块共存示例
+
+同一目录下，不同模块的文件自然共存，通过前缀区分：
+
+```
+logos/resources/prd/3-technical-plan/2-scenario-implementation/
+├── core-00-scenario-overview.md
+├── core-S01-cli-init.md
+├── core-S02-prd-writer.md
+├── payment-00-scenario-overview.md
+└── payment-S19-checkout.md        # 场景编号全局连续，不从 S01 重新开始
+```
+
+## 部署说明
+
+本文件（`spec/module-naming-convention.md`）是源码规范，由 `openlogos init` / `openlogos sync` 通过 `deploySpecs()` 自动部署到用户项目的 `logos/spec/` 目录。请勿直接修改 `logos/spec/` 下的副本。

package/spec/workflow.md

@@ -206,7 +206,7 @@ Phase 2 在 Phase 1 场景的基础上增加交互细节：
   - 来源：时序图 Step 序列（主路径）、EX 异常用例（异常路径）、Phase 1/2 验收条件
   - 关注：跨模块调用链的正确性、数据在 Step 间的传递、异常发生时的补偿/回滚逻辑
 
-**产出物**：测试用例规格文档（Markdown），存放在 `logos/resources/test/`，按场景分文件（如 `S01-test-cases.md`）。
+**产出物**：测试用例规格文档（Markdown），存放在 `logos/resources/test/`，按场景分文件（命名格式：`<module>-{场景编号}-test-cases.md`，如 `core-S01-test-cases.md`）。
 
 **Gate 3.3a**：核心场景的单元测试和场景测试用例已设计，覆盖所有 P0 场景的正常路径 + 核心 EX 异常路径。