@modus-ai/modus 0.1.0 → 0.1.2

package/templates/skills/modus-vibe/SKILL.md

@@ -1,3 +1,10 @@
+---
+name: modus-vibe
+description: Use this skill when executing /modus:vibe command for context-aware vibe coding. Loads relevant business Skills before coding so AI works as a knowledgeable project member. Trigger on /modus:vibe command or when user wants to code with business context. Supports --quick flag for simple single-file changes.
+allowed-tools: Read, Write, Glob, Bash
+disable: false
+---
+
 # modus-vibe（氛围编程）
 
 **触发条件：** 用户运行 `/modus:vibe [描述]` 时使用此 Skill。
@@ -117,13 +124,72 @@ B. 继续使用降级模式（无业务上下文，结果质量可能降低）
 如果理解无误，我来开始实现。
 ```
 
+### Step 5.5：内联设计思考（Design Brief CoT）
+
+**触发：** 每次编码任务前强制执行，不可跳过（包括 `--quick` 模式）。  
+**产出：** 内联于当前 LLM 上下文，**不写入任何文件**。
+
+调用 `modus-design-brief` Skill，传入：
+- `mode: vibe`（触发内联输出模式，不落盘）
+- `analysis_doc: 用户 prompt + Step 5 确认的意图摘要`
+- `business_skills: Step 4 已加载的 Skill 内容`
+- `constitution: Step 0 读取的 constitution 字段`
+
+Skill 将按 9 节结构，基于已加载上下文实时推导并输出以下内联块：
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+[Design Brief — 内联设计方案，仅用于本次编码，不写文件]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+## 1. 基本信息
+模式: vibe | 涉及域: {domain1}, {domain2}
+
+## 2. 业务意图摘要
+{来自 Step 5 的意图摘要}
+
+## 3. 实体与数据模型
+{基于 Skill [model] 条目和用户意图推导，字段带类型}
+
+## 4. API / 接口合同
+{方法签名，带完整包路径}
+
+## 5. 实现蓝图
+Data: {具体 Mapper 类/方法}
+Service: {具体 Manager/Service 类/方法，标注 @Transactional 位置}
+API: {Facade/Controller 类/方法}
+
+## 6. 边界条件与异常处理
+{覆盖关键失败路径，含错误码}
+
+## 7. 代码生成提示
+{来自 Skill key_files 的可复用类 + 命名规范示例}
+
+## 8. 禁止事项与已知坑
+{constitution hard_rules + Skill [pitfall]}
+
+## 9. 需求-任务追踪矩阵
+| 需求点 | 对应实现 | 对应校验方式 |
+|---|---|---|
+| {需求} | {类/方法} | {测试/联调} |
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+[End of Design Brief — 开始编码]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+**简化原则（vibe 模式）：**
+- 若 Skill 中某节内容明确，可适度精简，但不可省略节标题
+- 节 9 追踪矩阵在 vibe 模式下用「需求点→实现→校验方式」代替完整 Sprint 映射
+- 若 `--quick` 模式，节 3/4/9 可简化为一行摘要，但节 8 禁止事项必须完整输出
+
 ### Step 6：执行编码任务（Level 3 按需加载）
 
-基于已加载的业务上下文和澄清后的意图，执行用户的编码请求：
+基于 Step 5.5 内联设计方案和澄清后的意图，执行用户的编码请求：
 
-- 遵循项目已有的代码风格和命名规范（从 Skill 提取）
-- **严格遵守 constitution 中的 hard_rules**（比 Skill 中的建议优先级更高）
-- 引用已知的实体、接口、关键文件（避免臆造）
+- 以 Step 5.5 内联设计方案中节 5（实现蓝图）为编码路线图
+- 严格遵守节 8（禁止事项）——这是 constitution hard_rules 和 Skill [pitfall] 的汇总
+- 引用节 7（代码生成提示）中的现有类路径，不凭空创造类名
 - **Level 3 加载：** 需要具体代码实现时，按需读取 Skill 中 `关键文件索引` 指向的实际代码文件（而非预先全量读取）
 - 对不确定的业务规则，优先参考 Skill 中的规则描述
 - 如发现 Skill 中记录有误或过时，在回复末尾标注「Skill 更新建议」
@@ -138,13 +204,30 @@ B. 继续使用降级模式（无业务上下文，结果质量可能降低）
 - [pitfall] order 域：批量操作时若不分页会导致内存溢出
 ```
 
+### Step 8：写入 Session 日志
+
+编码完成后，将本次会话**追加**（append-only，禁止覆盖原有内容）到 `modus/sessions/vibe-log.md`：
+
+```markdown
+## {YYYY-MM-DD HH:mm} — {需求一句话摘要}
+
+- **涉及域：** {domain1}, {domain2}
+- **修改文件：** {变更文件列表，最多 5 个}
+- **Skill 更新建议：** {发现的新知识，无则填「无」}
+
+---
+```
+
+**为什么 append-only：** 多人同时使用时，各自只往文件末尾追加，不修改已有行，Git merge 自动无冲突。
+
 ---
 
 ## 氛围编程原则
 
-- **先理解再编码**：先复述对需求的理解，确认后再写代码
+- **先设计再编码**：Step 5.5 内联设计方案是编码的前置必要步骤，不可省略
+- **设计驱动**：编码时以内联设计方案的实现蓝图（节 5）为路线图，禁止事项（节 8）为红线
 - **有据可依**：引用的实体、字段、接口名必须来自 Skill 或已有代码
 - **风格一致**：生成的代码应与项目现有风格保持一致
-- **宪法优先**：constitution.hard_rules 是不可违反的底线，优先于一切
+- **宪法优先**：constitution.hard_rules 是不可违反的底线，优先于一切（已汇总到设计方案节 8）
 - **按需加载**：不预先读取所有 Skill，降低 token 消耗
 - **主动补全**：发现明显缺失（如缺少参数校验、日志）时主动补充