# Eo Module Init

> |

- **Type:** Skill
- **Install:** `agentstack add skill-simpleeve-eo-skills-eo-module-init`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [SimpleEve](https://agentstack.voostack.com/s/simpleeve)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [SimpleEve](https://github.com/SimpleEve)
- **Source:** https://github.com/SimpleEve/eo-skills/tree/main/eo-module-init

## Install

```sh
agentstack add skill-simpleeve-eo-skills-eo-module-init
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# eo-module-init — 模块初始化

为某个全新模块建立 `eo-doc/dev//spec.md` 活文档，过一次 spec-review 把基线质量把牢。**此 skill 一个模块只走一次**，后续所有修改通过 `/eo-change` 增量演化。

## 核心理念

1. **模块是一等公民**：独立目录 + 活文档 spec.md + changes/ 时间线
2. **基线质量**：只有模块首次建立时强制走 spec-review，后续增量 change 不再单独 review spec
3. **不含实施**：此 skill 只产出模块文档骨架，不写代码，不建 change

## 前置条件

- **必须能找到 `.eo-project.json`**。找不到 → 报错退出，提示运行 `/eo-project-init`。`eo-doc/` 路径通过 `doc_root` 字段解析
- 用户给定 `module-name`（小写 kebab-case，如 `inventory` / `transport-queue`）
- `eo-doc/dev//` 目录**不存在**（若存在则提示冲突，建议走 `/eo-change`）

## 工作流程

### 第一步：冲突检查

1. 检查 `eo-doc/dev//` 是否存在
2. 若存在：告知用户"该模块已存在，若要修改请走 `/eo-change`"，终止
3. 若不存在：继续

### 第二步：调用 eo-spec 写模块活文档

直接进入 **eo-spec 流程**（读其 SKILL.md 执行），产出位于 `eo-doc/dev//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 执行），对 `/spec.md` 做系统性审查，产出 `/spec-review.md`。

### 第五步：根据 review 结果迭代

- **无 P0/P1** → 通过，继续下一步
- **有 P0/P1** → 提示用户修订 `spec.md`，修订后删除 `spec-review.md` 重跑第四步
- 循环直到通过

### 第六步：建立 changes/ 骨架

1. 创建 `eo-doc/dev//changes/` 空目录
2. 创建 `eo-doc/dev//changes/INDEX.md`，写入表头：

```markdown
#  变更时间线

| 编号 | 标题 | 类型 | 状态 | 日期 | 摘要 |
|------|------|------|------|------|------|
```

### 第七步：更新全局索引

更新 `eo-doc/dev/INDEX.md`，添加该模块条目。

### 第八步：提示后续流程

告知用户：
> 模块 `` 初始化完成（spec 已就绪、code 未实现）。
>
> **首批实现 — 用 `bootstrap` 类型 change**：
> 1. 通读 `spec.md`，把"§3 核心行为"等能力章节按合理粒度拆成 1-N 个 bootstrap change（每个认领一部分章节，互不重叠）
> 2. 对每个 bootstrap：`/eo-change`（选 `change_type: bootstrap`，§3 写"实现范围"而不是 Delta）→ `/eo-implement` → `/eo-test` → `/eo-review` → `/eo-archive`
> 3. 全部 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）

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [SimpleEve](https://github.com/SimpleEve)
- **Source:** [SimpleEve/eo-skills](https://github.com/SimpleEve/eo-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-simpleeve-eo-skills-eo-module-init
- Seller: https://agentstack.voostack.com/s/simpleeve
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.