@modus-ai/modus 0.2.10 → 0.2.11

package/templates/skills/modus-init/shared/universal-skill-format.md

@@ -0,0 +1,362 @@
+---
+title: Universal Business Skill Format — 17 节通用骨架（语言无关）
+parent_skill: modus-init
+load_when: "执行 Step 8 生成业务 Skill 时按需读取；辅助命令 /modus:verify、/modus:refresh 执行时读取"
+---
+
+# Business Skill 通用 17 节骨架（语言无关）
+
+> ⚙️ **通用知识库核心原则**
+>
+> 1. **节号、节名、知识标签三者跨所有栈完全统一**——保证不同语言生成的知识库结构一致，跨栈 monorepo 可统一索引
+> 2. **节内具体填充按 `stack` 字段分流**——Java 写 Service/MyBatis 语义，前端写 Hook/API 调用语义，Go 写 Handler/GORM 语义
+> 3. 各 strategy 在生成时只需替换"节内填充示例"，**不允许新增/删除/重命名节标题**
+> 4. 跨栈语义对齐参见每节的"跨栈语义对齐表"
+
+---
+
+## 17 节总览（节号 + 节名 + 知识标签 — 跨栈完全一致）
+
+| # | 节标题 | 知识标签 | 跨栈语义概要 |
+|---|--------|---------|-------------|
+| 1 | 域概述 | — | 业务职责一句话 + 边界（属于/不属于） |
+| 2 | 核心实体 | `[model]` | Java=Entity / 前端=TS Type/Zod Schema / Go=struct |
+| 3 | 业务规则 | `[process][guideline][decision]` | 流程规则 + 推荐做法 + 架构决策 |
+| 4 | 关键文件索引 | `[model]` | 各栈的"分层"映射（Controller→Page→Handler）|
+| 5 | API 契约 | `[model]` | Java=暴露 REST/RPC / 前端=调用后端 endpoint |
+| 6 | 项目特有模式 | `[decision][guideline]` | 框架级编码范式（事务 / 状态管理 / 路由守卫） |
+| 7 | 典型代码示例 | — | 1 个写入场景 + 1 个查询场景，含项目特有模式 |
+| 8 | 状态机 | `[process]` | Java=Order 状态 / 前端=表单/页面状态机 |
+| 9 | 错误处理 | `[pitfall]` | Java=ErrorCode 枚举 / 前端=Toast/ErrorBoundary |
+| 10 | 跨域依赖 | `[decision]` | upstream/downstream + 接口版本 |
+| 11 | 数据流向 | `[process]` | Java=MQ/事件 / 前端=React Query/Pinia 数据链 |
+| 12 | 关键数据访问模式 | `[guideline]` | Java=SQL JOIN/索引 / 前端=API 调用：debounce/缓存/重试 |
+| 13 | 常见开发陷阱 | `[pitfall]` | 各栈典型陷阱 |
+| 14 | 扩展点/性能优化 | `[decision]` | Java=策略模式/SPI / 前端=路由懒加载/虚拟列表/memo |
+| 15 | 业务不变量 | `[invariant]` | 必须始终为真的业务约束（违反即 Bug） |
+| 16 | 领域词汇表 | `[model]` | 域内术语 + 与通用概念的差异 |
+| 17 | 新人上手指南 | `[process]` | 17.A Agent 快速定位 + 17.B 员工新人手册 |
+
+---
+
+## 跨栈语义对齐表（核心节）
+
+> 当 strategy 生成 Skill 时按本表替换节内"信号词"，但保持节标题不变。
+
+### 节 2 核心实体
+
+| stack | 数据载体 | 字段表填充 |
+|-------|---------|-----------|
+| `java` | `Entity` / `Domain` 类 | Java 类型（`Long`、`String`、`BigDecimal`） |
+| `frontend-react` | TS `interface` / `type` / Zod `schema` | TS 类型（`number`、`string`、`Date`），含可选标记 `?` |
+| `frontend-vue` | TS `interface` / `defineProps` 类型 / Pinia state | 同 React + 响应式标记 `Ref<T>` |
+| `backend-node` | Prisma model / TypeORM Entity / Zod schema | TS 类型 |
+| `go` | `struct` + `gorm` tag | Go 类型（`int64`、`string`、`time.Time`） |
+| `python` | Pydantic `BaseModel` / SQLAlchemy Model | Python 类型注解（`Optional[str]`、`Decimal`） |
+
+### 节 5 API 契约
+
+| stack | 含义 | 填充重点 |
+|-------|------|---------|
+| `java` | **本域对外暴露**的 REST/RPC 接口 | Controller/Facade 方法 + 权限注解 + 错误码 |
+| `frontend-*` | **本域调用**的后端 endpoint | endpoint 列表 + Request/Response TS 类型 + 鉴权方式 |
+| `backend-node` | **本域对外暴露**的 REST/GraphQL 接口 | Route/Resolver + 中间件链 |
+| `go` | **本域对外暴露**的 HTTP/gRPC 接口 | Handler 方法 + middleware + status code |
+
+### 节 6 项目特有模式
+
+| stack | 典型范式 |
+|-------|---------|
+| `java` | `@Transactional` / `AopContext.currentProxy()` / `@DistributedLock` / `BaseRpcResponse` 包装 |
+| `frontend-react` | Hook 命名约定（`useXxx`） / 状态管理选型（Redux/Zustand/Jotai） / 表单库（react-hook-form + zod） / 错误边界 |
+| `frontend-vue` | Composable 命名（`useXxx`） / Pinia store action / 路由守卫（beforeEach） / `<script setup>` |
+| `backend-node` | NestJS 模块/装饰器 / Express middleware 链 / `defer` 错误处理 |
+| `go` | 中间件链 / `defer` / gRPC status / context 传递 |
+
+### 节 8 状态机
+
+| stack | 主要承载对象 |
+|-------|------------|
+| `java` | Domain Entity 的 `status` 字段（含 `@Transactional` 保护标注） |
+| `frontend-react` | 表单状态机（idle→loading→success→error） / XState / 页面流 / 异步操作状态 |
+| `frontend-vue` | 同 React + 响应式 ref 状态 |
+| `backend-*` | 业务对象状态字段 |
+
+### 节 9 错误处理
+
+| stack | 表现形式 |
+|-------|---------|
+| `java` | ErrorCode 枚举 + Exception 类 + HTTP 状态码 + `@RestControllerAdvice` |
+| `frontend-react` | Error Boundary / toast 时机 / fallback UI / 表单字段错误展示 / 路由守卫拦截 |
+| `frontend-vue` | `errorHandler` / Suspense fallback / VeeValidate 错误展示 |
+| `backend-node` | 全局异常过滤器 / problem-details JSON |
+| `go` | error 包装 / sentinel error / status code 映射 |
+
+### 节 12 关键数据访问模式
+
+| stack | 含义 |
+|-------|------|
+| `java` | XML Mapper / MyBatis-Plus / SQL JOIN / 索引命中 / 慢查询风险 |
+| `frontend-*` | API 调用模式：debounce / throttle / 重试 / 缓存（React Query/SWR） / 取消（AbortController） / 乐观更新 |
+| `backend-node` | Prisma/TypeORM 查询 + N+1 风险 |
+| `go` | GORM/sqlx 查询 + 索引利用 |
+| `python` | SQLAlchemy ORM / 原生 SQL |
+
+### 节 13 常见开发陷阱
+
+| stack | 典型陷阱举例（仅举一二） |
+|-------|---------|
+| `java` | 同类调用 `@Transactional` 失效 / 枚举存 `name()` 导致改名失数据 / 并发未加分布式锁导致重复 |
+| `frontend-react` | Closure 陷阱 / 依赖数组 / SSR Hydration 不一致 / Memory Leak / 不必要 re-render / 异步 setState 时机 |
+| `frontend-vue` | ref vs reactive 解构丢响应式 / watch immediate vs watchEffect / v-for + v-if 同元素冲突 / Nuxt SSR useState 服务端复用 |
+| `backend-node` | async 错误未捕获 / 中间件顺序错乱 / 全局变量泄漏 |
+| `go` | goroutine 泄漏 / channel 未关闭 / context 取消未传递 |
+
+### 节 14 扩展点/性能优化
+
+| stack | 维度 |
+|-------|------|
+| `java` | 策略模式（多实现）/ `@ConditionalOn*` 条件装配 / SPI / 缓存 / N+1 优化 |
+| `frontend-react` | 路由懒加载 / 虚拟列表 / `React.memo`/`useMemo`/`useCallback` / Suspense / Code Split / 预加载 |
+| `frontend-vue` | 异步组件 / `v-once` / KeepAlive / 路由懒加载 / 大列表虚拟滚动 |
+| `backend-*` | 索引优化 / 缓存层 / 异步队列 / 批处理 |
+
+---
+
+## 17 节标准模板（Markdown 主体，所有栈通用）
+
+> 各 strategy 在 Step 8 生成 Skill 时复用本模板，仅替换 frontmatter（按 `shared/frontmatter-spec.md`）和节内填充示例。
+
+```markdown
+# {中文域名}业务知识
+
+> 由 Modus Skills Builder 自动生成。[MODUS:BIZ] | stack: {stack}
+
+---
+
+> **渐进加载模式（Agent 按任务类型选择，降低 token 消耗）：**
+>
+> | 模式 | 读取范围 | 预估 token | 适用场景 |
+> |------|---------|-----------|---------|
+> | **极简模式** | Section 1、2、15 | ~500 tokens | 快速了解业务边界和不变量 |
+> | **开发模式** | Section 1-8、10 | ~1500 tokens | 新增功能、接口/页面开发 |
+> | **审查模式** | Section 3、8、13、15 | ~1000 tokens | Code Review、架构评审 |
+> | **排查模式** | Section 9、13 + Section 8 | ~600 tokens | 线上 Bug 排查、异常分析 |
+> | **完整模式** | 全量（Section 1-17） | ~3500 tokens | 首次接触本域、生成设计文档 |
+>
+> **新人速读路径：** Section 16（词汇表）→ Section 17.B（新人手册）→ Section 8（状态机）→ Section 3（业务规则）
+> **排障路径：** Section 9（错误码）→ Section 13（陷阱）→ Section 15（不变量）
+>
+> **Skill 状态：** `[SKILL_STATUS]` | **栈：** `[STACK]` | **更新：** `[UPDATED]` | **hash：** `[HASH_PREFIX]`
+> 若 status 为 `stale`，禁止直接引用，先运行 `/modus:refresh {domain}`
+
+---
+
+## 1. 域概述
+
+{业务域的职责边界和核心价值，2-3 句话}
+
+**边界说明：**
+- 属于本域：{列举主要职责}
+- 不属于本域：{明确排除的职责}
+
+## 2. 核心实体 [model]
+
+> 按 stack 填充：`java` 列 Java 类型；`frontend-*` 列 TS 类型；`go` 列 Go struct；`python` 列 Pydantic 字段。
+
+| 实体名 | 中文名 | 说明 | 关键字段 |
+|--------|--------|------|----------|
+| {EntityName} | {中文名} | {说明} | {字段列表，含类型} |
+
+### 重要枚举/常量 [model]
+
+\`\`\`{lang}
+// {EnumName} — {含义}
+{枚举值列表}
+\`\`\`
+
+## 3. 业务规则 [process] [guideline] [decision]
+
+### 核心字段说明
+
+每个核心字段必含：类型、是否非空、业务含义、关联枚举（如有）
+
+| 字段 | 类型 | 非空 | 业务含义 | 关联枚举 |
+|------|------|------|----------|----------|
+
+### 业务流程规则 [process]
+- [process] {流程规则}
+
+### 推荐做法 [guideline]
+- [guideline] {推荐做法}
+
+### 架构决策 [decision]
+- [decision] {架构决策}
+
+> **信号词分流指引（跨栈通用）：**
+>
+> | 信号词模式 | 正确归属 |
+> |----------|---------|
+> | 「必须/禁止 + 违反=Bug/事故」 | Section 15 `[invariant]` |
+> | 「推荐/建议/最佳实践」 | Section 3 `[guideline]` |
+> | 「如果 A 则 B 流程」 | Section 3 `[process]` |
+> | 「选 A 而非 B，因为...」 | Section 3 `[decision]` |
+> | 「曾踩过/容易犯」 | Section 13 `[pitfall]` |
+> | 「新人首次开发前需了解」 | Section 17 |
+
+## 4. 关键文件索引 [model]
+
+> 按栈分层填充。各栈的"层"定义参见对应 strategy 文件。
+
+| 层次 | 名称 | 路径 | 说明 |
+|------|------|------|------|
+
+## 5. API 契约 [model]
+
+> `java`/`backend-*`：本域**对外暴露**的接口；`frontend-*`：本域**调用**的后端 endpoint。
+
+每个接口必含：入参校验、返回结构、错误码/HTTP 状态、是否幂等、权限/鉴权方式
+
+| 方法 | 路径/方法名 | 说明 | 关键参数 | 鉴权 | 幂等 |
+|------|------|------|----------|----------|------|
+
+## 6. 项目特有模式 [decision] [guideline]
+
+- [guideline] {模式 1}
+- [guideline] {模式 2}
+
+## 7. 典型代码示例
+
+要求：
+- 来自实际扫描的源码（不能是纯伪代码）
+- 至少 1 个"写入/变更"场景 + 1 个"查询/权限"场景
+- 体现 Section 6 的项目特有模式
+- 含关键步骤的内联注释
+
+\`\`\`{lang}
+// {代码示例 1}
+\`\`\`
+
+## 8. 状态机 [process]
+
+**前置条件：** 域中存在状态字段（Java 的 `status` / 前端的表单状态/页面状态/XState）才生成本节。
+
+\`\`\`mermaid
+stateDiagram-v2
+    [*] --> {INITIAL}
+    {INITIAL} --> {NEXT} : {触发条件}
+\`\`\`
+
+### 正常流转表
+| 起始 | 目标 | 触发条件 | 触发方法/事件 | 事务/批处理 |
+|------|------|----------|--------------|------------|
+
+### 异常流（前置条件：存在 FAILED/ERROR 类状态）
+### 超时自动流转（前置条件：存在定时任务/TTL）
+### 补偿机制（前置条件：存在 MQ 消费者/异步队列）
+
+## 9. 错误处理 [pitfall]
+
+| 错误码/错误名 | 触发场景 | 用户感知/HTTP 状态 | 处理建议 |
+|--------|---------|---------|---------|
+
+## 10. 跨域依赖 [decision]
+
+**上游依赖：**
+| 依赖域 | 交互方式 | 调用点 | 接口版本 | 降级预案 |
+|--------|---------|-------|---------|---------|
+
+**下游被依赖：**
+| 调用域 | 交互方式 | 接口版本（本域提供）| 场景 |
+|--------|---------|-----------------|------|
+
+> **契约版本维护规则：**
+> - 本域对外接口版本记录在 frontmatter `contract_version`
+> - 调用方在 Section 10 上游依赖表记录调用时使用的版本号
+> - 接口升级时：① 更新 `contract_version` ② 通知下游域 ③ 触发 hash 更新
+
+## 11. 数据流向 [process]
+
+**前置条件（按栈而异）：**
+- `java`：MQ Consumer/Producer / Spring Event / `@Async` 跨域调用
+- `frontend-*`：React Query/SWR/Pinia 数据链 / WebSocket/SSE / 跨组件事件总线
+- `go`/`python`：消息队列 / 任务队列
+
+| 方向 | Topic/Hook/Channel | 触发时机 | 上下游 | 幂等/防抖保障 |
+|------|-----------|---------|------------|---------|
+
+## 12. 关键数据访问模式 [guideline]
+
+**前置条件（按栈而异）：**
+- `java`：复杂 SQL（≥2 表 JOIN 或子查询）
+- `frontend-*`：API 调用模式（缓存/重试/取消/乐观更新）
+- `go`/`python`：复杂查询
+
+| 标识 | 语义 | 关键技术点 | 性能/数据量 | 风险 |
+|------|------|------------|------------|---------|
+
+## 13. 常见开发陷阱 [pitfall]
+
+- [pitfall] {陷阱 1}
+- [pitfall] {陷阱 2}
+
+## 14. 扩展点/性能优化 [decision]
+
+**前置条件：** 域中存在 ≥2 实现的接口/策略 / `@ConditionalOn*` 条件装配 / 前端的懒加载/虚拟列表/memo / SPI 注册点。
+
+| 扩展点/优化点 | 实现方式 | 当前实例 | 扩展/调整方式 |
+|--------|---------|---------|---------|
+
+## 15. 业务不变量 [invariant]
+
+| 不变量描述 | 验证位置 | 违反后果 | 来源 |
+|---------|---------|---------|------|
+
+## 16. 领域词汇表 [model]
+
+| 术语 | 定义 | 与通用概念的区别 |
+|------|------|----------------|
+
+## 17. 新人上手指南 [process]
+
+### 17.A Agent 快速定位指南（机器优先）
+
+| 任务类型 | 必读 Section | 关键文件 | 核心约束提示 |
+|---------|------------|---------|------------|
+
+### 17.B 员工新人入门手册（人类优先）
+
+#### 开发前必读清单
+1. ...
+#### 本域关键设计决策历史
+| 设计决策 | 选择方案 | 未选方案 | 设计理由 |
+|---------|---------|---------|---------|
+#### 本地环境搭建 Checklist
+（按栈而异：Java=MQ/RPC/DB；前端=mock/proxy/env；Go=context/db；Python=venv/db）
+#### 首次开发任务推荐
+#### 常见问题 FAQ
+#### 高频踩坑（精选自 Section 13 前 3 条）
+
+---
+<!-- 更新摘要（由 Skills Builder 自动追加）
+[{YYYY-MM-DD}] {stack} strategy 生成：17节完整格式（v3-{stack}），扫描 {M} 个文件，不变量{I}条，词汇{G}个，隐性知识率{H}%
+-->
+```
+
+---
+
+## 节级最低内容门槛（用于 `/modus:verify`）
+
+| 节 | 最低门槛（自检通过条件） |
+|---|------------------------|
+| Section 2 | 至少 1 个核心实体；字段表非空；含枚举的域必须列出枚举值 |
+| Section 3 | 字段说明表非空；至少 1 条 `[process]` 或 `[guideline]` |
+| Section 5 | 接口表非空；每接口含鉴权与幂等标注 |
+| Section 7 | 至少 1 段真实源码（非占位符） |
+| Section 8 | 存在状态字段时必须有状态图 + 转换表 |
+| Section 13 | draft(used) 状态时禁止仅写"暂无发现" |
+| Section 15 | 至少 1 条不变量；从 `if/else 推断 + 校验器分析 + 人工访谈`三源任一写入 |
+| Section 16 | 至少 3 个术语；非通用概念必须给出"差异说明" |
+| Section 17 | 17.A 至少覆盖 5 种任务类型；17.B 至少覆盖"开发前必读"+"FAQ"+"高频踩坑" |
+
+> 不满足任一门槛 → `/modus:verify` 报警；强制修复后才能从 `draft` 升为 `verified`。

package/templates/skills/modus-init/strategies/fallback-init.md

@@ -0,0 +1,150 @@
+---
+title: Fallback Strategy — 通用 Glob 兜底（任意未识别项目）
+parent_skill: modus-init
+load_when: "Router 在 Step 0.5 检测到 primaryStack=fallback / go / python / rust / backend-node 时加载（前 4 项为待 Phase 4 扩展的占位栈）"
+stack: fallback | go | python | rust | backend-node
+---
+
+# Fallback Strategy（通用 Glob 兜底）
+
+> 当 Router 在 Step 0.5 命中以下情况时加载本文档：
+> - `primaryStack = fallback`（未检测出任何已知栈）
+> - `primaryStack = go / python / rust / backend-node`（已识别但暂无专属 strategy，等 Phase 4 扩展）
+>
+> 本 strategy 提供**简化但可用**的扫描和 Skill 生成流程，确保 `/modus:init` 在任何项目下都能产出可用的知识库，不报错。
+
+---
+
+## §1 适用场景
+
+| 场景 | 行为 |
+|------|------|
+| Go / Python / Rust / Node 后端 | 跳过精细的语义扫描，按目录前缀分组 |
+| 完全未识别项目（无 build 文件） | 仅按 `src/` 或 `app/` 子目录分组，提示用户手动调整 |
+| 用户主动选 fallback | 同上 |
+
+---
+
+## §2 简化的 5 轮扫描（按目录前缀分组）
+
+### 轮次 1：模块发现
+
+按以下信号逐项检查：
+
+| 信号 | 模块识别方式 |
+|------|-----------|
+| `go.mod` | 单 module；按子包（含 `*.go` 的目录）分组 |
+| `pyproject.toml` / `setup.py` | 单 package；按 `src/<pkg>/` 子目录分组 |
+| `Cargo.toml` | 单 crate；按 `src/<mod>/` 分组 |
+| `package.json`（NestJS/Express） | 按 `src/modules/<name>/` 分组 |
+| 都没有 | 按 `src/` 或 `app/` 一级子目录分组 |
+
+输出：
+```
+[1/5 模块发现] ✓ 发现 {N} 个候选模块（兜底模式：按目录前缀分组）
+```
+
+### 轮次 2：文件清单（仅按扩展名分布）
+
+按扩展名统计每个候选模块的文件数：
+
+| 扩展名 | 含义 |
+|--------|------|
+| `.go` | Go 源码 |
+| `.py` | Python 源码 |
+| `.rs` | Rust 源码 |
+| `.ts` / `.js` | Node 后端源码 |
+| `.sql` | 数据库脚本 |
+| `.proto` | Protocol Buffers 契约 |
+
+不做语义分类，仅做计数：
+
+```
+src/order/        — 18 个 .go 文件 + 2 个 .sql + 1 个 .proto
+src/payment/      — 12 个 .go 文件 + 1 个 .sql
+src/user/         — 8 个 .go 文件
+```
+
+### 轮次 3：候选域语义（弱推断）
+
+仅做包名/目录名匹配业务名词（`order/pay/user/payment/inventory/track/album` 等）：
+
+```
+src/order/    → 候选域 biz-order    [置信度 Medium]
+src/payment/  → 候选域 biz-payment  [置信度 Medium]
+src/utils/    → 通用层（不入业务域）
+```
+
+> **关键：兜底模式下置信度统一标 Medium**，强制用户手动确认每个域归属（不允许自动跳过）。
+
+### 轮次 4 / 5：跳过
+
+- 跨域依赖：跳过（Section 10 留"暂无发现，随工作流积累"）
+- 资源所有权：跳过（Section 12 留"暂无发现，随工作流积累"）
+
+---
+
+## §3 简化的 6 节业务 Skill 模板
+
+> 兜底模式下生成的 Skill 仅含**最关键的 6 节**，节号保持与通用 17 节骨架一致（不重新编号），其余节标记为「暂无发现，随工作流积累」。
+>
+> Section 编号保留与通用骨架完全一致，便于后续用户升级到完整 17 节时无需重排。
+
+| 必生成节 | 内容来源 |
+|---------|---------|
+| **1 域概述** | 用户在确认阶段输入的一句话职责 |
+| **3 业务规则** | 仅扫描注释中的 `// TODO/FIXME/NOTE` |
+| **4 关键文件索引** | 模块下文件清单（按扩展名分类） |
+| **5 API 契约** | 扫描简单信号：HTTP handler / gRPC method / FastAPI route / Express route |
+| **13 常见开发陷阱** | 「暂无发现，随工作流积累」 |
+| **17 新人上手指南** | 仅 17.B 简化版：模块入口文件 + 启动命令 + 主要目录 |
+
+其余节（2/6/7/8/9/10/11/12/14/15/16）保留节标题，节内统一填充：
+
+```markdown
+## {N}. {节标题} {标签}
+
+> 暂无发现，随工作流积累（fallback strategy 简化生成）。
+> 升级路径：当本项目栈被 modus 框架正式支持后，可运行 `/modus:init --enhance {domain}` 重新生成完整 17 节。
+```
+
+---
+
+## §4 兜底模式的 frontmatter
+
+```yaml
+stack: fallback                  # 或 go / python / rust / backend-node（按实际检测）
+format_version: v3-fallback      # 标记为兜底简化版
+key_files: [...]                 # 仍按"按扩展名分布前 20 个"选取
+external_deps: {}                # 不解析；用户可手动补充
+domain_confidence: 5             # 兜底统一 Medium
+```
+
+> 其他防腐字段全部按 `shared/frontmatter-spec.md` 规范，不允许漏写。
+
+---
+
+## §5 兜底模式的提示与升级路径
+
+Step 14 完成回报必须包含：
+
+```
+⚠️ 当前项目栈（{primaryStack}）未深度适配，已使用 fallback strategy 生成简化 6 节业务 Skill。
+   - 本次产出：{N} 个域，每域含 6 节核心知识 + 11 节占位
+   - 限制：跨域依赖图、资源所有权图、状态机均为占位
+   - 升级路径：
+     1. 等 Modus 后续版本支持本栈（Phase 4：go-init / python-init）
+     2. 通过 /modus:platform -add 反馈需求（含范式样例）
+     3. 手动编辑 modus/knowledge/biz-*/SKILL.md 补充内容，运行 /modus:verify 升级
+```
+
+---
+
+## §6 用户提供范式样例后的迁移路径
+
+当用户后续提供具体语言（如 Go）的代码范式后：
+
+1. **新建** `templates/skills/modus-init/strategies/go-init.md`（参照 java-init.md 的结构）
+2. **更新** `shared/stack-detection.md` 第 2 节：将 `go` 路由到新文件
+3. **更新** `shared/universal-skill-format.md` 第"跨栈语义对齐表"加入 Go 栈条目
+4. **保留兼容性**：本 fallback-init.md 不删除，作为永远的兜底入口