MuniuLiuma（木牛流马）

将原始需求文档高效转化为可交付代码的全流程 Skill 包。5 个 Phase 按数据依赖串联，根据用户意图和上下文状态自动决策执行范围。

命令

/mnlm           触发 Skill，Agent 根据用户意图和上下文自动决策执行范围

用户也可通过自然语言触发（如"解析这份需求"、"做架构设计"、"拆任务"、"检查完成情况"），Agent 自动识别对应的执行范围。

触发判断

第一步：开发意图检测

第二步：自动触发建议

在开发意图检测过程中，如果用户没有主动要求结构化分析，但检测到以下信号，Agent 主动建议是否使用 MuniuLiuma：

• 用户拒绝后不再重复建议，除非需求复杂度显著增加（如新增 3 个以上功能点）
• 用户主动说"不用""直接做"时，尊重用户选择

不触发时保持静默，等待用户进一步指示。

第三步：输入内容验证（仅 Phase 1）

触发后判断文档类型：

• 是 PRD / 需求文档 / 功能描述 → 进入解析流程
• 是其他类型（API 文档、设计稿、会议纪要等） → 告知"这不是需求文档（检测到类型：XX）"，询问意图
• 无法判断 → 主动询问"这是需求文档吗？需要我解析吗？"

范围评估

触发后、进入决策流程前，评估需求规模是否适合走全流程：

用户坚持走全流程时尊重用户选择，但在输出中标注范围评估结果。

项目模式识别

根据上下文判断当前属于哪种开发模式：

Brownfield 模式下 Phase 2 的额外步骤：

1. 扫描项目现有架构（模块划分、技术栈、API 风格）
2. 分析新需求对现有架构的影响（新增/修改/不变）
3. 做架构一致性检查（新设计是否与现有模式冲突）
4. 标注与现有架构不一致的地方，供用户确认

决策流程

收到用户指令后，按以下步骤判断执行范围：

第一步：确定目标 Phase

第二步：递归检查前置依赖

目标 Phase N 的 [必需] 输入都存在？
  ├── ✅ 全部存在 → 直接从 Phase N 开始执行
  └── ❌ 缺失 → 回溯到 Phase N-1
        ├── Phase N-1 的输入存在 → 执行 Phase N-1 → 输出传给 Phase N
        └── 仍缺失 → 继续回溯...直至 Phase 1

各 Phase 的必需输入：

第三步：执行并输出

1. 按补齐后的链路依次执行，中间产物保留在对话上下文中
2. 遵循「输出规范」完成最终输出
3. 每个 Phase 执行完毕后，将关键产物展示给用户确认，用户确认后再进入下一 Phase

Agent 停止规则

以下场景中 Agent 必须暂停执行并向用户确认，而非自行继续：

执行示例

标准路径

范围评估场景

Brownfield / 已有项目场景

异常与回退场景

错误处理与降级

遇到异常时采取降级而非中断：

降级原则：

• 即使降级也要输出部分结果，而非直接失败
• 降级输出必须标注哪些环节被跳过或简化，以及原因
• 始终提供可操作的下一步建议

上下文管理

1. 按需加载：只加载目标 Phase 对应的 reference 文件，不预加载下游 Phase
2. 产物传递：上游输出直接作为下游输入，不重复生成或复述
3. 大文档分段：PRD 过长时按章节/模块分段处理，独立提取后合并
4. 输出精简：只包含结构化结果，不包含分析过程和备选方案论述
5. 产物外部化：每个 Phase 输出末尾建议用户保存为文件（遵循「产物保存规则」，不主动创建）
6. 溢出降级：优先保证目标 Phase 的必需输入和结构化输出完整，可裁剪分析过程

输出规范

所有 Phase 遵循以下规则：

• 输出为纯 Markdown，不依赖特定渲染器
• 输出语言默认中文，可通过自然语言指令切换英文（如"用英文输出"）
• 只输出目标 Phase 的结果（中间 Phase 的产物不单独展示，除非用户要求）
• 产物末尾附"建议保存为文件"的提示（仅提示，不主动写入）
• 上游 Phase 在本次调用中重新执行过时，标注"⚠️ 下游产物可能已过期"

产物保存规则

产物默认输出到对话上下文，不主动创建文件。文件保存遵循以下规则：

触发条件

仅在以下情况才创建或写入文件：

• 用户明确要求"保存到文件"、"写入文件"、"导出"等
• 上下文接近窗口极限时，提示用户是否需要保存（仍需用户确认后才执行）

禁止在无用户授权的情况下自行创建文件。

保存路径

• 首次保存：询问用户希望保存到哪个目录，并给出建议路径（如 prd/specs/）
• 后续保存：复用同项目中已确认的目录，无需重复询问
• 如用户未指定，使用以下默认建议路径：

保存后

• 告知用户文件已保存的完整路径
• 询问用户是否继续执行下一步（如架构设计、任务拆解等），用户确认后 Agent 自动执行

Phase Reference

执行对应 Phase 时，加载以下 reference 文件获取详细指令：