momo-ai 1.0.5 → 1.0.7

package/.momo/advanced/refer.json

@@ -0,0 +1,50 @@
+{
+    "maven": {
+        "file": "pom.xml",
+        "target": "reference/maven"
+    },
+    "gradle": {
+        "file": "build.gradle",
+        "target": "reference/gradle"
+    },
+    "npm": {
+        "file": "package.json",
+        "target": "reference/npm"
+    },
+    "rust": {
+        "file": "Cargo.toml",
+        "target": "reference/rust"
+    },
+    "go": {
+        "file": "go.mod",
+        "target": "reference/go"
+    },
+    "ruby": {
+        "file": "Gemfile",
+        "target": "reference/ruby"
+    },
+    "python": {
+        "file": "requirements.txt",
+        "target": "reference/python"
+    },
+    "php": {
+        "file": "composer.json",
+        "target": "reference/php"
+    },
+    "dotnet": {
+        "file": "project.csproj",
+        "target": "reference/dotnet"
+    },
+    "java": {
+        "file": "pom.xml",
+        "target": "reference/java"
+    },
+    "cmake": {
+        "file": "CMakeLists.txt",
+        "target": "reference/cmake"
+    },
+    "make": {
+        "file": "Makefile",
+        "target": "reference/make"
+    }
+}

package/README.md

@@ -5,6 +5,8 @@
 
 ## 1. 介绍
 
+### 1.1. 功能说明
+
 当前工具会在操作系统中安装 `momo` 命令，使用它进行 `SDD - Spec Driven Development` 开发：
 
 1. 参考：`OpenSpec / Spec-Kit / Kiro`
@@ -22,6 +24,30 @@
 
 > 除开 `momo` 命令后续会提供和模型直接交互的 `lain` 命令，近似 `iFlow / openspec` 的功能。
 
+### 1.2. 开始步骤
+
+1. 使用 `momo init` 初始化协同工程项目（运行之前可使用 `momo env` 检查环境）。
+2. 使用 `momo repo` 添加项目代码库以及工程实例（有多少个 `Agent` 工作就添加多少工程实例），添加完成后可使用 `momo open`
+   直接打开工程。
+3. 更新 `project.md / project-model.md / requirement.md` 的细节文档（可用AI帮助拆分和书写）
+4. 使用 `momo add -n 需求名称` 添加细节需求（可用AI帮助拆分和书写：`momo plan -n 需求名称`）
+5. 使用 `momo tasks` 列出所有任务，并且使用 `momo run` 运行任务得到任务提示词
+
+> 带 (CV) 📋️ 标记的命令——运行成功后可直接“Ctrl + V”粘贴到 TRAE / Lingma / Cursor / Kiro 中执行。
+
+### 1.3. 项目计划
+
+1. 使用 `momo project` 将后端项目拷贝到 `reference` 目录中（主要是提供数据模型）。
+2. （唯一的人工处理）更新 `project.md` 中的所有信息，核心包括：
+    - 功能描述
+    - 场景描述等
+    - 风格
+    - 技术栈
+3. 使用 `momo agentcfg` 给 TRAE 工具配置智能体，主要是导入部分已经定制好的智能体。
+4. 使用 `momo agent -a "智能体名称"` 调用智能体进行开发之前的准备工作，目前支持的智能体可直接使用 `momo agentcfg` 查看。
+
+<hr/>
+
 ## 2. 工具使用
 
 ### 2.1. 安装
@@ -32,67 +58,55 @@ npm install -g momo-ai
 momo help
 ```
 
-### 2.2. 操作步骤
-
-1. 使用 `momo init` 初始化协同工程项目（运行之前可使用 `momo env` 检查环境）。
-2. 使用 `momo repo` 添加项目代码库以及工程实例（有多少个 `Agent` 工作就添加多少工程实例），添加完成后可使用 `momo open`
-   直接打开工程。
-3. 更新 `project.md / project-model.md / requirement.md` 的细节文档（可用AI帮助拆分和书写）
-4. 使用 `momo add -n 需求名称` 添加细节需求（可用AI帮助拆分和书写：`momo plan -n 需求名称`）
-5. 使用 `momo tasks` 列出所有任务，并且使用 `momo run` 运行任务得到任务提示词
-
-> 带 (CV) 标记的命令运行成功后可直接“Ctrl + V”粘贴到 TRAE / Lingma / Cursor / Kiro 中执行。
-
 ### 2.3. 命令：不定模型
 
 ```bash
 # ------------ 工程初始化 -----------------
-# 检查环境相关信息
-momo env                    # 环境检查
+# 🌷 环境检查、工程和代码初始化、工具启动等
+momo env                            # 环境检查
 
-# momo init
-momo init -d app-fly        # 初始化 directory = app-fly 的项目
-momo init                   # 初始化当前项目
+momo init -d app-fly                # 初始化 directory = app-fly 的项目
+momo init                           # 初始化当前项目
 
-# momo repo 
 momo repo -a https://xxx/repo.git   # 克隆远程代码库 -> source/repo/develop-01（名称靠解析） -> git submodule
 momo repo -a xxx -i 10              # 克隆远程代码库（10个副本）
 
 momo open                           # 交互式使用 TRAE / Lingma / Cursor / Kiro 打开当前项目
 
-# ------------ 需求管理 -----------------
-# momo add
-momo add -n "需求名称"               # 添加新需求 -> changes 下追加新内容 -> 包括任务
-momo add -n "需求 md 文档路径"        # 添加需求文档 -> changes 下追加新内容 -> 包括任务，如果带后缀直接用文件名做需求名称
+momo project -s "项目路径"           # 将路径中的显示拷贝到当前项目的 reference 目录下，若不提供 -s 则直接列举所有支持的项目类型
 
-# momo plan               
-momo plan -n "需求名称"              # 生成需求的整体开发计划 -> prompt 剪切板
+momo agentcfg                       # 列出所有智能体，并且打开浏览器配置
+momo agent -a "智能体名称"           # 📋️ 调用智能体 -> prompt 得到提示词到剪切板
+
+# ------------ 需求相关 -----------------
+# 🌷 需求管理：添加、归档、校验、列出、显示
+momo add -n "需求名称"               # 📋️ 添加新需求 -> changes 下追加新内容 -> 包括任务
+momo add -n "需求(MD)文档路径"        # 📋️ 添加需求文档 -> changes 下追加新内容 -> 包括任务，如果带后缀直接用文件名做需求名称
 
-# momo archive
 momo archive -n "需求名称"           # 需求归档 -> archive 下追加新内容，删除 changes 下内容
 
-# momo show
 momo show -n "需求名称"              # 显示需求 -> 显示 changes 下内容
 
-# momo validate
 momo validate -n "需求名称"          # 需求校验 -> 校验 changes 下内容
 
-# momo list
 momo list                           # 列出所有需求 -> changes 下内容
 
-# ------------ 任务执行 -----------------
-# momo tasks
-momo tasks                          # 显示任务 -> 需求 / 任务 / 状态 -> 状态 = 待办 / 进行中 / 已完成
 
-# momo actors
+# 🌷 需求分析：计划、执行、拆分
+momo plan -n "需求名称"              # 📋️ 生成需求的整体开发计划 -> prompt 剪切板
+
+# ------------ 任务执行 -----------------
+# 🌷 任务执行：定义角色、执行任务
 momo actors                         # 列出所有角色
 
-# momo actor                        
 momo actor -a "角色名称"             # 添加新角色 -> 交互式命令，每个角色可以指定不同的大模型
 
-# momo run                          ( 生成提示词 -> 剪切板，自动计算空闲的 source-01 ）
-momo run -a {actor} -t {task}       # 将任务分配给角色，检查执行目录看哪些任务正在执行
-momo run                            # 从菜单中选择任务
+
+momo tasks                          # 📋️ 显示任务 -> 需求 / 任务 / 状态 -> 状态 = 待办 / 进行中 / 已完成
+
+momo run -a {actor} -t {task}       # 📋️ 将任务分配给角色，检查执行目录看哪些任务正在执行
+momo run                            # 📋️ 从菜单中选择任务
+
 momo unlock                         # 解锁任务 -> 任务状态 = 待办
 ```
 
@@ -100,6 +114,40 @@ momo unlock                         # 解锁任务 -> 任务状态 = 待办
 
 > 控制台开发中（Lain 模式）
 
+```bash
+# 两个命令都可以启动控制台
+momo console                        # 启动 Lain 控制台 -> 交互式命令
+lain                                # 启动 Lain 控制台 -> 交互式命令
+```
+
+打开控制台
+
+```bash
+[Momo AI] ----------------- Rachel Momo / AI工具项  ------------------
+[Momo AI] 应用名称: Rachel Momo / SDD
+[Momo AI] 工具主页: https://gitee.com/silentbalanceyh/r2mo-lain
+[Momo AI] 工具版本: 1.0.6  ( Node >= 22.x )
+[Momo AI]
+[Momo AI] ----------------- AI 系统启动…… ----------------------------
+
+================================================================================================
+                                    Momo AI / Lain Console
+================================================================================================
+
+欢迎使用 Momo AI / Lain 控制台！
+这是一个交互式命令行界面。
+
+可用命令：
+  help     - 显示帮助信息
+  llm      - 查看大模型配置信息
+  quit     - 退出控制台
+
+请在提示符后输入命令。
+------------------------------------------------------------------------------------------------
+```
+
+<hr/>
+
 ## 3. 参考链接
 
 ### 3.1. 旧版

package/package.json

@@ -1,10 +1,11 @@
 {
     "name": "momo-ai",
-    "version": "1.0.5",
+    "version": "1.0.7",
     "description": "Rachel Momo ( OpenSpec )",
     "main": "src/momo.js",
     "bin": {
-        "momo": "./src/momo.js"
+        "momo": "./src/momo.js",
+        "lain": "./src/lain.js"
     },
     "scripts": {
         "test": "src/index.test.js"

package/src/_agent/trae/momo-datamodel.json

@@ -0,0 +1,5 @@
+{
+    "name": "领域建模师",
+    "id": "momo-datamodel",
+    "uri": "https://s.trae.ai/a/a9dcaa"
+}

package/src/_agent/trae/momo-module-req.json

@@ -0,0 +1,5 @@
+{
+    "name": "模块需求分析师",
+    "id": "momo-module-req",
+    "uri": "https://s.trae.ai/a/c4fc46"
+}

package/src/_agent/trae/momo-system-req.json

@@ -0,0 +1,5 @@
+{
+    "name": "系统需求分析师",
+    "id": "momo-system-req",
+    "uri": "https://s.trae.ai/a/d0c6b9"
+}

package/src/_agent/trae/momo-task.json

@@ -0,0 +1,5 @@
+{
+    "name": "任务规划师",
+    "id": "momo-task",
+    "uri": "https://s.trae.ai/a/1fdc4e"
+}

package/src/_template/LAIN/AGENTS.md

@@ -1,95 +1,102 @@
 # AI Agents 集成说明
 
-本文档描述了项目中支持的 AI Agents 及其集成方式，确保所有 Agent 能够正确理解项目结构和工作流程。
-
-## 支持的 AI Agents
-
-### OpenSpec
-- 集成目录: `integration/openspec/`
-- 配置文件: `integration/openspec/config.json`
-- 用途: OpenSpec 标准化开发流程集成
-
-### SpecKit
-- 集成目录: `integration/spec-kit/`
-- 用途: SpecKit 工具链集成
-
-### Kiro
-- 集成目录: `integration/kiro/`
-- 用途: Kiro 开发框架集成
-
-### Trea
-- 集成目录: `integration/trea/`
-- 用途: Trea 工具集集成
-
-### Cursor
-- 集成目录: `integration/cursor/`
-- 用途: Cursor IDE 集成
-
-### Lingma
-- 集成目录: `integration/lingma/`
-- 用途: Lingma 开发助手集成
-
-### Qoder
-- 集成目录: `integration/qoder/`
-- 用途: Qoder 编码助手集成
-
-### WindSurf
-- 集成目录: `integration/windsurf/`
-- 用途: WindSurf 开发工具集成
-
-### GitHub Copilot
-- 集成目录: `integration/github/`
-- 用途: GitHub Copilot 集成
-
-### Claude Code
-- 集成目录: `integration/claude-code/`
-- 用途: Claude Code Assistant 集成
-
-### ChatGPT
-- 集成目录: `integration/chatgpt/`
-- 用途: ChatGPT 集成
-
-## 项目结构说明
-
-### 核心目录
-
-1. `.momo/` - Momo AI 核心配置目录
-   - `prompt/` - 提示词存储目录
-   - `template/` - 模板文件目录
-   - `advanced/` - 高级配置目录
-   - `scripts/` - 自定义脚本目录
-
-2. `specification/` - 规范文档目录
-   - `project.md` - 项目基本信息
-   - `project-model.md` - 项目数据模型
-   - `requirement.md` - 基础需求说明
-   - `changes/` - 需求变更目录
-   - `actor/` - 角色定义目录
-   - `.archives/` - 归档需求目录
-   - `.activities/` - 活动记录目录
-
-3. `source/` - 源代码目录
-   - 包含多个开发实例目录，如 `develop-01`, `develop-02` 等
-
-4. `integration/` - 工具集成目录
-   - 包含各种 AI 工具的集成配置
-
-## 工作流程
-
-### 需求管理流程
-
-1. 使用 `momo add` 添加新需求
-2. 使用 `momo plan` 制定开发计划
+本文档用于帮助 AI 编码助手理解项目结构和工作流程。通过遵循本文档中的规范，AI 可以更准确地协助开发工作。
+
+## 项目工作流程
+
+1. **需求分析** - 定义和分析业务需求
+2. **任务规划** - 将需求分解为可执行的任务
+3. **角色分配** - 为每个任务分配合适的 AI 或人类角色
+4. **代码实现** - 执行具体任务并生成代码
+5. **测试验证** - 验证实现是否满足需求
+6. **归档提交** - 将完成的工作归档并提交
+
+## 可用 Agents
+
+### 领域建模师
+- Arg Name: `momo-datamodel`
+- 用途: 根据需求文档设计领域模型和数据结构
+- id = momo-datamodel, uri = https://s.trae.ai/a/a9dcaa
+
+### 系统需求分析师
+- Arg Name: `momo-system-req`
+- 用途: 分析系统级需求并生成技术规格
+- id = momo-system-req, uri = https://s.trae.ai/a/d0c6b9
+
+### 模块需求分析师
+- Arg Name: `momo-module-req`
+- 用途: 分析模块级需求并细化功能规格
+- id = momo-module-req, uri = https://s.trae.ai/a/c4fc46
+
+### 任务规划师
+- Arg Name: `momo-task`
+- 用途: 将需求分解为具体可执行的任务
+- id = momo-task, uri = https://s.trae.ai/a/1fdc4e
+
+## 项目目录结构
+
+```
+project/
+├── .momo/
+│   ├── advanced/
+│   ├── prompt/
+│   ├── scripts/
+│   └── template/
+├── integration/
+├── source/
+├── specification/
+│   ├── .activities/
+│   ├── .archives/
+│   ├── actor/
+│   ├── changes/
+│   │   └── {change-id}/
+│   │       ├── proposal.md
+│   │       ├── tasks.md
+│   │       └── tasks/
+│   │           └── {task-id}.md
+│   ├── project-model.md
+│   ├── project.md
+│   └── requirement.md
+└── README.md
+```
+
+## 关键文件说明
+
+### specification/project.md
+项目概述文件，包含项目基本信息、技术栈、架构风格等。
+
+### specification/project-model.md
+项目数据模型文件，包含核心领域模型和数据结构定义。
+
+### specification/requirement.md
+项目需求文件，包含用户群描述、场景描述、功能需求等。
+
+### specification/changes/{change-id}/proposal.md
+变更提案文件，描述需求变更的内容和影响范围。
+
+### specification/changes/{change-id}/tasks.md
+任务列表文件，包含为实现变更所需执行的具体任务。
+
+### specification/changes/{change-id}/tasks/{task-id}.md
+具体任务文件，包含任务的详细说明和执行指南。
+
+## 工作流程规范
+
+### 需求变更流程
+1. 使用 `momo add -n "需求名称"` 创建新的需求变更
+2. 使用 `momo plan -n "需求名称"` 生成开发计划
 3. 使用 `momo run` 执行具体任务
-4. 使用 `momo archive` 归档完成的需求
+4. 使用 `momo archive -n "需求名称"` 归档完成的需求
 
 ### 角色管理流程
+1. 使用 `momo actors` 查看所有已定义角色
+2. 使用 `momo actor -a "角色名称"` 创建新角色
 
-1. 使用 `momo actors` 查看所有角色
-2. 使用 `momo actor` 添加新角色
-3. 角色配置文件存储在 `specification/actor/` 目录下
+### 任务执行流程
+1. 使用 `momo tasks` 查看所有待执行任务
+2. 使用 `momo run -a {actor} -t {task}` 分配任务给角色执行
 
-## 提示词使用规范
+## 提示词规范
 
 1. 所有提示词存储在 `.momo/prompt/` 目录中
 2. 使用 `momo run` 命令时会自动将相关提示词复制到剪贴板
@@ -100,4 +107,4 @@
 1. 请勿直接修改 `specification/changes/` 目录下的文件，应通过 `momo` 命令进行管理
 2. 所有需求变更应遵循 OpenSpec 标准流程
 3. 归档的需求存储在 `specification/.archives/` 目录中，可通过时间戳识别
-4. 不同 AI 工具应使用对应的 `integration/` 子目录进行配置
+4. 不同 AI 工具应使用对应的 `integration/` 子目录进行配置

package/src/_template/PROMPT/plan.md.ejs

@@ -1,4 +1,4 @@
-# 添加需求提示词
+# 需求计划提示词
 
 <!-- BEGIN -->
 阅读 specification/project.md 中的基本需求信息，根据 <%= NAME %> 的描述信息，重新制定需求的开发计划，更改掉 specification/changes/<%= NAME %>/ 目录中的需求说明，重新制定任务清单并且更新（子任务清单在specification/changes/<%= NAME %>/tasks/目录下），项目本身的技术栈和数据模型可参考 specification/project-model.md 文件。

package/src/_template/PROMPT/trae/momo-datamodel.ejs

@@ -0,0 +1,8 @@
+# 领域建模提示词
+
+<!-- BEGIN -->
+分析 reference/ 下的项目，查找对应的数据模型，根据查找的数据模型更新  specification/project-model.md 文档作为当前项目所需的领域模型核心文档
+
+1. 主要分析实体模型、关系模型、常量和枚举等。
+2. 若分析过程中出现了多种不同的项目则让我选择用哪种项目做初始分析。
+<!-- END -->

package/src/_template/PROMPT/trae/momo-module-req.ejs

@@ -0,0 +1,11 @@
+# 模块需求提示词
+
+<!-- BEGIN -->
+详细解读 specification/requirement.md 需求文档中的模块和每个模块的功能列表，在 specification/changes/ 目录之下创建模块的核心文档，每个模块用 MXX- 前缀，其中 XX 是模块编号。
+
+1. 每个模块中包括 tasks/ 目录、任务明细文档存放位置。
+2. 每个模块中包括 proposal.md，此文档中用来存放模块的详细需求。
+3. 每个模块中包括 tasks.md，此文档中是描述所有任务的总清单。
+4. 模块所需的数据模型可参考 specification/project-model.md 文档。
+5. 有多少模块在于你的模块的整体设计，记得模块内部业务要形成完整闭环。
+<!-- END -->

package/src/_template/PROMPT/trae/momo-system-req.ejs

@@ -0,0 +1,9 @@
+# 系统需求提示词
+
+<!-- BEGIN -->
+根据人工提供的 specification/project.md 的详细需求描述进行核心分析，生成一份当前项目的比较规范的需求描述文档，用文档更新 specification/requirement.md 文档，这份需求文档的读者是前端架构师和前端工程师，所以一定要阐述清楚整个系统实现想要达到的效果和功能
+
+1. 数据模型可以参考 specification/project-model.md 文档。
+2. 技术栈信息可以直接从 specification/project.md 需求文档中提取。
+3. 输出文档中一定要输出的核心内容：模块清单、模块中的功能列表。
+<!-- END -->

package/src/_template/PROMPT/trae/momo-task.ejs

@@ -0,0 +1,11 @@
+# 领域建模提示词
+
+<!-- BEGIN -->
+解读 specification/changes/ 下的所有模块（必须是 MXX- 开头的目录）对应的变更内容，并生成领域模型，根据每个目录中的 tasks.md 生成对应的任务并且更新 tasks.md 文件：
+
+1. 每个模块的详细需求位于 specification/changes/MXX-模块/proposal.md 文件中。
+2. 每个任务存放在 specification/changes/MXX-模块/tasks/ 目录下。
+3. 任务文件名统一成 MXX-TNNN.md，其中 NN 是任务编号，NNN 是任务编号，编号长度不足用 0 填充。
+4. 每个任务文件中要写出任务实施过程的详细步骤。
+5. 系统相关的数据模型参考 specification/data-model.md 文件。
+<!-- END -->

package/src/commander/agent.json

@@ -0,0 +1,12 @@
+{
+    "executor": "executeAgent",
+    "description": "加载并复制指定 Agent 的提示词到剪切板",
+    "command": "agent",
+    "options": [
+        {
+            "name": "agent",
+            "alias": "a",
+            "description": "智能体名称（Arg Name）"
+        }
+    ]
+}

package/src/commander/agentcfg.json

@@ -0,0 +1,5 @@
+{
+    "executor": "executeAgentCfg",
+    "description": "配置和打开系统内置 agents",
+    "command": "agentcfg"
+}

package/src/commander/console.json

@@ -0,0 +1,7 @@
+{
+    "executor": "executeConsole",
+    "description": "启动交互式控制台",
+    "command": "console",
+    "options": [
+    ]
+}

package/src/commander/lain.json

@@ -0,0 +1,7 @@
+{
+    "executor": "executeConsole",
+    "description": "启动交互式控制台",
+    "command": "lain",
+    "options": [
+    ]
+}

package/src/commander/project.json

@@ -0,0 +1,12 @@
+{
+    "executor": "executeProject",
+    "description": "引用外部项目到 reference 目录中",
+    "command": "project",
+    "options": [
+        {
+            "name": "source",
+            "alias": "s",
+            "description": "项目路径，必须提供"
+        }
+    ]
+}