| name | eo-module-init |
| description | 为全新模块建立 spec 活文档并完成首次 spec-review，打好后续所有 change 的基线。触发：新建模块 / module init / 新模块 / /eo-module-init。
NOT FOR: 修改已有模块（走 /eo-change）。
|
eo-module-init — 模块初始化
为某个全新模块建立 eo-doc/dev/<module-name>/spec.md 活文档，过一次 spec-review 把基线质量把牢。此 skill 一个模块只走一次，后续所有修改通过 /eo-change 增量演化。
核心理念
- 模块是一等公民：独立目录 + 活文档 spec.md + changes/ 时间线
- 基线质量：只有模块首次建立时强制走 spec-review，后续增量 change 不再单独 review spec
- 不含实施：此 skill 只产出模块文档骨架，不写代码，不建 change
前置条件
- 必须能找到
.eo-project.json。找不到 → 报错退出，提示运行 /eo-project-init。eo-doc/ 路径通过 doc_root 字段解析
- 用户给定
module-name（小写 kebab-case，如 inventory / transport-queue）
eo-doc/dev/<module-name>/ 目录不存在（若存在则提示冲突，建议走 /eo-change）
工作流程
第一步：冲突检查
- 检查
eo-doc/dev/<module-name>/ 是否存在
- 若存在：告知用户"该模块已存在，若要修改请走
/eo-change"，终止
- 若不存在：继续
第二步：调用 eo-spec 写模块活文档
直接进入 eo-spec 流程（读其 SKILL.md 执行），产出位于 eo-doc/dev/<module-name>/spec.md 的模块 spec。
注意：
- 术语统一为
module-name（不是 spec-name）
- spec 定位是"模块当前能力快照 + 持续活文档"，而非"一次性功能规格"
- spec.md 同目录会一并生成 spec-history.md（变更历史）：「变更记录」表含「模块初始化」初始行、「关联变更」表初始为空，后续由 eo-archive 维护
第三步：用户确认 → status: confirmed
用户确认 spec 无误后，将 frontmatter 的 status 从 draft 改为 confirmed。
第四步：触发 eo-spec-review
直接进入 eo-spec-review 流程（读其 SKILL.md 执行），对 <module-name>/spec.md 做系统性审查，产出 <module-name>/spec-review.md。
第五步：根据 review 结果迭代
- 无 P0/P1 → 通过，继续下一步
- 有 P0/P1 → 提示用户修订
spec.md，修订后删除 spec-review.md 重跑第四步
- 循环直到通过
第六步：建立 changes/ 骨架
- 创建
eo-doc/dev/<module-name>/changes/ 空目录
- 创建
eo-doc/dev/<module-name>/changes/INDEX.md，写入表头：
# <module-name> 变更时间线
| 编号 | 标题 | 类型 | 状态 | 日期 | 摘要 |
|------|------|------|------|------|------|
第七步：更新全局索引
更新 eo-doc/dev/INDEX.md，添加该模块条目。
第八步：提示后续流程
告知用户：
模块 <module-name> 初始化完成（spec 已就绪、code 未实现）。
首批实现 — 用 bootstrap 类型 change：
- 通读
spec.md，把"§3 核心行为"等能力章节按合理粒度拆成 1-N 个 bootstrap change（每个认领一部分章节，互不重叠）
- 对每个 bootstrap：
/eo-change（选 change_type: bootstrap，§3 写"实现范围"而不是 Delta）→ /eo-implement → /eo-test → /eo-review → /eo-archive
- 全部 bootstrap 归档完毕 = spec 全量落地为代码
后续演化 — 用 feature / enhance / refactor：
当代码已存在、需要新增/修改/重构能力时，按对应类型发 change，§3 写 Delta（ADDED/MODIFIED/REMOVED）。
后续不要再跑 /eo-module-init 或单独 /eo-spec。
关键约束
- 一次性：一个模块只走一次 module-init
- 强制 spec-review：模块基线必须过 review，不可跳过
- 不产出 change / 代码：此 skill 只负责建立模块骨架
- module-name 命名：小写 kebab-case（如
hero / inventory / transport-queue）
- 与 eo-change 的分工：
- 模块不存在 → eo-module-init
- 模块已存在 → eo-change（哪怕是"大改 spec"，也走 refactor 类型的 change）
