@gong-ym/ai-spec-auto 0.2.14 → 0.2.15

package/.agents/rules/common/14-/345/256/241/350/256/241/346/261/207/346/212/245/350/247/204/350/214/203.md

@@ -1,107 +1,107 @@
----
-alwaysApply: false
-description: 执行审计汇报规范，要求 AI 在产出代码变更后附带结构化、可核对的审计报告。当执行 tasks.md 任务、批量实现、或完成任何产出代码变更的操作后读取此规则。
----
-
-# 审计汇报规范
-
-## 适用范围
-
-当 AI 完成以下任何操作后，必须附带审计报告：
-
-- 执行 `tasks.md` 中的单条任务（execute-task 第四步）
-- 批量实现多条任务
-- 完成 `create-proposal` 后置检查
-- 任何产出代码文件变更的操作
-
-## 核心约束（NON-NEGOTIABLE）
-
-1. **禁止虚假声明**：禁止在未使用 Read 工具实际读取某文件时声称「已加载」「已读取」该文件。只有工具调用记录中存在对应 Read 操作的，才可标记为「已 Read」。
-2. **禁止笼统表述**：禁止用「遵循了团队规范」「按规范执行」等笼统措辞替代具体规范条目引用。必须指明规范文件名 + 具体章节/表格/条目。
-3. **明确区分读取状态**：「已 Read」与「未 Read，行为上对齐」是两种不同状态，必须如实标注，不可混淆。
-4. **偏差必须披露**：凡与技能定义的步骤不一致之处（如跳过确认、跳过 TDD、批量执行等），必须在报告中明确写出，不可隐瞒。
-
-## 审计报告模板
-
-每次审计报告包含以下五个区块，按顺序输出：
-
-### 区块 1：读取记录
-
-列出本次操作中涉及的所有规范文件和技能文件，标注实际读取状态。
-
-| 类型 | 文件路径 | 状态 |
-|------|---------|------|
-| 技能 | `.agents/skills/xxx/SKILL.md` | 已 Read / 未 Read |
-| 规则 | `.agents/rules/xxx.md` | 已 Read / 未 Read，依据 xxx 推断 |
-| 设计 | `openspec/changes/xxx/design.md` | 已 Read / 未 Read |
-| 任务 | `openspec/changes/xxx/tasks.md` | 已 Read |
-
-状态取值说明：
-
-- **已 Read**：本次对话中使用 Read 工具读取过该文件
-- **未 Read，依据 X 推断**：未直接读取，但依据其它已读文件（如 tasks.md、design.md）中的描述推断行为
-- **未 Read，凭既有知识**：未读取，依据训练知识或上下文惯例行事
-
-### 区块 2：操作记录
-
-按时间顺序列出所有工具调用，包括文件操作和终端命令。
-
-格式：`序号. 工具名: 文件路径或命令（操作说明）`
-
-示例：
-
-```
-1. Read: package.json
-2. Write: src/services/auth.ts（新建认证服务模块）
-3. StrReplace: src/router/index.ts（添加 /auth 路由入口）
-4. Shell: npm install <dependency>
-```
-
-### 区块 3：规范对齐
-
-列出代码中的关键决策点，以及其对应的具体规范条目。
-
-| 操作 | 对应规范 | 具体条目 |
-|------|---------|---------|
-| 模块目录命名 kebab-case | `02-编码规范.md` | 「命名规范」目录/模块一栏 |
-| 接口封装统一通过服务层 | 各 profile 的 API/接口规范 | 「接口请求规范」节 |
-| 新增功能附带测试用例 | 各 profile 的测试规范 | 「质量门禁」节 |
-
-若无明确规范对应（如纯业务逻辑），可写「无对应规范，按业务需求实现」。
-
-### 区块 4：技能执行状态
-
-列出本次操作涉及或应涉及的技能，标注执行状态。
-
-| 技能 | 状态 | 备注 |
-|------|------|------|
-| execute-task | 已 Read，按四步循环执行 | — |
-| create-component | 未 Read，行为上对齐 | tasks.md 已写明组件结构 |
-| theme-variables | 未涉及 | 本次任务不涉及样式 |
-
-### 区块 5：与规范/技能不一致处
-
-列出所有偏离规范或技能要求的地方，必须说明原因。
-
-示例：
-
-- execute-task 要求逐步确认，本回合用户指示批量执行，未逐步询问
-- TDD RED 阶段：项目未配置测试框架，改用类型断言兜底
-- 未执行双重审查中的「架构对齐」，因本次仅修改配置文件
-
-若完全一致，写「无偏差」。
-
-## 简化规则
-
-为避免审计报告过于冗长影响效率，以下场景可使用精简版：
-
-| 场景 | 精简方式 |
-|------|---------|
-| 单条简单任务（如修改一个文件） | 区块 2 和区块 3 可合并为一行 |
-| 连续执行同类任务（如连续创建多个 API） | 多条任务共用一份报告，按任务编号分列 |
-| 非行为性变更（拼写、注释、格式） | 可省略本规范（同 12-Superpowers执行规范 的跳过条件） |
-
-## 相关规范与技能
-
-- `.agents/rules/12-Superpowers执行规范.md` — 执行原则（本规范作为其第 4 关卡）
-- `.agents/skills/execute-task/SKILL.md` — Superpowers 四步循环（第四步引用本规范）
+---
+alwaysApply: false
+description: 执行审计汇报规范，要求 AI 在产出代码变更后附带结构化、可核对的审计报告。当执行 tasks.md 任务、批量实现、或完成任何产出代码变更的操作后读取此规则。
+---
+
+# 审计汇报规范
+
+## 适用范围
+
+当 AI 完成以下任何操作后，必须附带审计报告：
+
+- 执行 `tasks.md` 中的单条任务（execute-task 第四步）
+- 批量实现多条任务
+- 完成 `create-proposal` 后置检查
+- 任何产出代码文件变更的操作
+
+## 核心约束（NON-NEGOTIABLE）
+
+1. **禁止虚假声明**：禁止在未使用 Read 工具实际读取某文件时声称「已加载」「已读取」该文件。只有工具调用记录中存在对应 Read 操作的，才可标记为「已 Read」。
+2. **禁止笼统表述**：禁止用「遵循了团队规范」「按规范执行」等笼统措辞替代具体规范条目引用。必须指明规范文件名 + 具体章节/表格/条目。
+3. **明确区分读取状态**：「已 Read」与「未 Read，行为上对齐」是两种不同状态，必须如实标注，不可混淆。
+4. **偏差必须披露**：凡与技能定义的步骤不一致之处（如跳过确认、跳过 TDD、批量执行等），必须在报告中明确写出，不可隐瞒。
+
+## 审计报告模板
+
+每次审计报告包含以下五个区块，按顺序输出：
+
+### 区块 1：读取记录
+
+列出本次操作中涉及的所有规范文件和技能文件，标注实际读取状态。
+
+| 类型 | 文件路径 | 状态 |
+|------|---------|------|
+| 技能 | `.agents/skills/xxx/SKILL.md` | 已 Read / 未 Read |
+| 规则 | `.agents/rules/xxx.md` | 已 Read / 未 Read，依据 xxx 推断 |
+| 设计 | `openspec/changes/xxx/design.md` | 已 Read / 未 Read |
+| 任务 | `openspec/changes/xxx/tasks.md` | 已 Read |
+
+状态取值说明：
+
+- **已 Read**：本次对话中使用 Read 工具读取过该文件
+- **未 Read，依据 X 推断**：未直接读取，但依据其它已读文件（如 tasks.md、design.md）中的描述推断行为
+- **未 Read，凭既有知识**：未读取，依据训练知识或上下文惯例行事
+
+### 区块 2：操作记录
+
+按时间顺序列出所有工具调用，包括文件操作和终端命令。
+
+格式：`序号. 工具名: 文件路径或命令（操作说明）`
+
+示例：
+
+```
+1. Read: package.json
+2. Write: src/services/auth.ts（新建认证服务模块）
+3. StrReplace: src/router/index.ts（添加 /auth 路由入口）
+4. Shell: npm install <dependency>
+```
+
+### 区块 3：规范对齐
+
+列出代码中的关键决策点，以及其对应的具体规范条目。
+
+| 操作 | 对应规范 | 具体条目 |
+|------|---------|---------|
+| 模块目录命名 kebab-case | `02-编码规范.md` | 「命名规范」目录/模块一栏 |
+| 接口封装统一通过服务层 | 各 profile 的 API/接口规范 | 「接口请求规范」节 |
+| 新增功能附带测试用例 | 各 profile 的测试规范 | 「质量门禁」节 |
+
+若无明确规范对应（如纯业务逻辑），可写「无对应规范，按业务需求实现」。
+
+### 区块 4：技能执行状态
+
+列出本次操作涉及或应涉及的技能，标注执行状态。
+
+| 技能 | 状态 | 备注 |
+|------|------|------|
+| execute-task | 已 Read，按四步循环执行 | — |
+| create-component | 未 Read，行为上对齐 | tasks.md 已写明组件结构 |
+| theme-variables | 未涉及 | 本次任务不涉及样式 |
+
+### 区块 5：与规范/技能不一致处
+
+列出所有偏离规范或技能要求的地方，必须说明原因。
+
+示例：
+
+- execute-task 要求逐步确认，本回合用户指示批量执行，未逐步询问
+- TDD RED 阶段：项目未配置测试框架，改用类型断言兜底
+- 未执行双重审查中的「架构对齐」，因本次仅修改配置文件
+
+若完全一致，写「无偏差」。
+
+## 简化规则
+
+为避免审计报告过于冗长影响效率，以下场景可使用精简版：
+
+| 场景 | 精简方式 |
+|------|---------|
+| 单条简单任务（如修改一个文件） | 区块 2 和区块 3 可合并为一行 |
+| 连续执行同类任务（如连续创建多个 API） | 多条任务共用一份报告，按任务编号分列 |
+| 非行为性变更（拼写、注释、格式） | 可省略本规范（同 12-Superpowers执行规范 的跳过条件） |
+
+## 相关规范与技能
+
+- `.agents/rules/12-Superpowers执行规范.md` — 执行原则（本规范作为其第 4 关卡）
+- `.agents/skills/execute-task/SKILL.md` — Superpowers 四步循环（第四步引用本规范）

package/.agents/rules/common/15-visual-gate-wait.md

@@ -1,90 +1,90 @@
-# 15 — Visual 门禁等待规范（ai-spec-auto / 所有 profile 共用）
-
-> 目的：当 `/spec-start` 或其他协议推进命中门禁（`status=waiting-approval`）时，
-> 让 IDE 中的 AI **在原对话里主动轮询** `.ai-spec/gate-signal.json`，实现
-> "Visual 页面点批准 → 原对话自动继续"的无人值守体验。
->
-> 本规则为强制切面规则（优先级高于默认等待行为），但允许项目级 `.cursor/rules/overrides/*`
-> 调整轮询参数。所有 IO 失败必须静默降级，绝不阻断主协议推进。
-
-## 15.1 触发条件（必须）
-
-同时满足以下两项时，AI **必须立即进入** "visual 门禁等待循环"，而不是挂起询问用户：
-
-1. `.ai-spec/current-run.json` 中 `status === "waiting-approval"` 且 `pending_gate` 非空
-2. `.ai-spec/visual-bridge.json` 存在且 `enabled !== false`
-
-若 visual-bridge 未启用或不存在，视为"纯本地模式"，按原有人工确认流程处理，**不** 进入本循环。
-
-## 15.2 循环算法（每轮 3 秒，最多 20 轮 = 60 秒）
-
-```text
-waitStartedAt := Date.now()
-currentRunId  := current-run.json.run_id
-currentGate   := current-run.json.pending_gate
-
-for i in 1..20:
-    sleep 3s
-    在对话输出一行："[T+{i*3}s] 等待 Visual 审批（run=<runId> gate=<gate>）..."
-    try:
-        signal := read JSON from .ai-spec/gate-signal.json
-    catch any:
-        signal := null   # 文件不存在 / JSON 损坏 → 继续等
-
-    if signal 满足以下全部条件:
-        - signal.schema_version === 1
-        - signal.run_id === currentRunId
-        - signal.gate === currentGate
-        - signal.ts_ms > waitStartedAt
-    then:
-        if signal.decision in ("approved", "resumed"):
-            汇报"已收到 Visual 审批：<decision>，继续执行 /spec-continue"
-            执行 /spec-continue
-            return
-        if signal.decision === "rejected":
-            汇报"Visual 审批被拒绝：<signal.reason>，停止本轮推进。"
-            return
-
-# 60 秒仍无信号 → 默认自动放行
-汇报"60 秒内未收到 Visual 审批决定，按默认策略自动放行，继续执行 /spec-continue"
-执行 /spec-continue
-```
-
-> 陈旧信号防误触：`signal.ts_ms > waitStartedAt` 的校验能自动忽略上一轮遗留的 gate-signal.json。
-> 这是本规则的关键幂等保证，不得省略。
-
-## 15.3 AI 行为契约（必须遵守）
-
-- **不许** 在循环期间询问用户"要不要继续"。循环本身就是等待机制。
-- **不许** 读到任意 gate-signal 就直接 `/spec-continue`，必须通过 15.2 的四项校验。
-- **不许** 跳过 60 秒超时（除非项目级 override 显式设置 `visualGateWait.timeoutMs`）。
-- **必须** 每轮输出一行进度，保证原对话可见。
-- **必须** 整个循环用户仍可随时打断（Ctrl+C / 发送新消息），打断后视为人工接管，本规则不再自动推进。
-
-## 15.4 异常兜底
-
-| 情况 | 处理 |
-|---|---|
-| `current-run.json` 读失败 | 退回人工询问（本规则不适用） |
-| `gate-signal.json` JSON 损坏 | 当次视为"无信号"，继续等 |
-| `.ai-spec/` 目录不存在 | 退回人工询问 |
-| 循环中抛出任何异常 | 捕获后汇报错误 + 继续下一轮；连续 3 次异常 → 按超时路径默认放行 |
-
-## 15.5 与既有资产的关系
-
-- 本规则与 `.ai-spec/next-step.md`（由 `inbox-consumer.js` 追加写入）互为双通道：
-  `next-step.md` 提供人类可读的审批历史；`gate-signal.json` 提供机器可判定的即时信号。
-  **AI 推进决策以 `gate-signal.json` 为准**，`next-step.md` 仅作审计参考。
-- 不改变、不覆盖、不依赖 Cursor hook / Claude Code hook 能力；仅依赖文件系统读取。
-- 与 `cli.js visual watch` 守护解耦：watch 负责把 Visual 侧 outbox 应用到本地并写 gate-signal，
-  AI 负责读取并决策；两者独立失败独立恢复。
-
-## 15.6 项目级覆盖（可选）
-
-业务仓可在 `.cursor/rules/overrides/visual-gate-wait.md` 声明以下参数覆盖默认值：
-
-- `intervalMs`（默认 3000）
-- `maxAttempts`（默认 20）
-- `defaultOnTimeout`（`"continue"` | `"pause"`，默认 `"continue"`）
-
-当 `defaultOnTimeout === "pause"` 时，超时后 AI 退回人工询问；否则按默认放行。
+# 15 — Visual 门禁等待规范（ai-spec-auto / 所有 profile 共用）
+
+> 目的：当 `/spec-start` 或其他协议推进命中门禁（`status=waiting-approval`）时，
+> 让 IDE 中的 AI **在原对话里主动轮询** `.ai-spec/gate-signal.json`，实现
+> "Visual 页面点批准 → 原对话自动继续"的无人值守体验。
+>
+> 本规则为强制切面规则（优先级高于默认等待行为），但允许项目级 `.cursor/rules/overrides/*`
+> 调整轮询参数。所有 IO 失败必须静默降级，绝不阻断主协议推进。
+
+## 15.1 触发条件（必须）
+
+同时满足以下两项时，AI **必须立即进入** "visual 门禁等待循环"，而不是挂起询问用户：
+
+1. `.ai-spec/current-run.json` 中 `status === "waiting-approval"` 且 `pending_gate` 非空
+2. `.ai-spec/visual-bridge.json` 存在且 `enabled !== false`
+
+若 visual-bridge 未启用或不存在，视为"纯本地模式"，按原有人工确认流程处理，**不** 进入本循环。
+
+## 15.2 循环算法（每轮 3 秒，最多 20 轮 = 60 秒）
+
+```text
+waitStartedAt := Date.now()
+currentRunId  := current-run.json.run_id
+currentGate   := current-run.json.pending_gate
+
+for i in 1..20:
+    sleep 3s
+    在对话输出一行："[T+{i*3}s] 等待 Visual 审批（run=<runId> gate=<gate>）..."
+    try:
+        signal := read JSON from .ai-spec/gate-signal.json
+    catch any:
+        signal := null   # 文件不存在 / JSON 损坏 → 继续等
+
+    if signal 满足以下全部条件:
+        - signal.schema_version === 1
+        - signal.run_id === currentRunId
+        - signal.gate === currentGate
+        - signal.ts_ms > waitStartedAt
+    then:
+        if signal.decision in ("approved", "resumed"):
+            汇报"已收到 Visual 审批：<decision>，继续执行 /spec-continue"
+            执行 /spec-continue
+            return
+        if signal.decision === "rejected":
+            汇报"Visual 审批被拒绝：<signal.reason>，停止本轮推进。"
+            return
+
+# 60 秒仍无信号 → 默认自动放行
+汇报"60 秒内未收到 Visual 审批决定，按默认策略自动放行，继续执行 /spec-continue"
+执行 /spec-continue
+```
+
+> 陈旧信号防误触：`signal.ts_ms > waitStartedAt` 的校验能自动忽略上一轮遗留的 gate-signal.json。
+> 这是本规则的关键幂等保证，不得省略。
+
+## 15.3 AI 行为契约（必须遵守）
+
+- **不许** 在循环期间询问用户"要不要继续"。循环本身就是等待机制。
+- **不许** 读到任意 gate-signal 就直接 `/spec-continue`，必须通过 15.2 的四项校验。
+- **不许** 跳过 60 秒超时（除非项目级 override 显式设置 `visualGateWait.timeoutMs`）。
+- **必须** 每轮输出一行进度，保证原对话可见。
+- **必须** 整个循环用户仍可随时打断（Ctrl+C / 发送新消息），打断后视为人工接管，本规则不再自动推进。
+
+## 15.4 异常兜底
+
+| 情况 | 处理 |
+|---|---|
+| `current-run.json` 读失败 | 退回人工询问（本规则不适用） |
+| `gate-signal.json` JSON 损坏 | 当次视为"无信号"，继续等 |
+| `.ai-spec/` 目录不存在 | 退回人工询问 |
+| 循环中抛出任何异常 | 捕获后汇报错误 + 继续下一轮；连续 3 次异常 → 按超时路径默认放行 |
+
+## 15.5 与既有资产的关系
+
+- 本规则与 `.ai-spec/next-step.md`（由 `inbox-consumer.js` 追加写入）互为双通道：
+  `next-step.md` 提供人类可读的审批历史；`gate-signal.json` 提供机器可判定的即时信号。
+  **AI 推进决策以 `gate-signal.json` 为准**，`next-step.md` 仅作审计参考。
+- 不改变、不覆盖、不依赖 Cursor hook / Claude Code hook 能力；仅依赖文件系统读取。
+- 与 `cli.js visual watch` 守护解耦：watch 负责把 Visual 侧 outbox 应用到本地并写 gate-signal，
+  AI 负责读取并决策；两者独立失败独立恢复。
+
+## 15.6 项目级覆盖（可选）
+
+业务仓可在 `.cursor/rules/overrides/visual-gate-wait.md` 声明以下参数覆盖默认值：
+
+- `intervalMs`（默认 3000）
+- `maxAttempts`（默认 20）
+- `defaultOnTimeout`（`"continue"` | `"pause"`，默认 `"continue"`）
+
+当 `defaultOnTimeout === "pause"` 时，超时后 AI 退回人工询问；否则按默认放行。

package/.agents/rules/profiles/nestjs/01-/351/241/271/347/233/256/346/246/202/350/277/260.md

@@ -1,27 +1,27 @@
----
-alwaysApply: false
-description: NestJS 项目概述，描述项目定位、技术栈、模块结构与核心依赖。当了解项目背景或进行整体规划时读取此规则。
----
-
-# 项目概述（NestJS）
-
-> 本文件由 `project-init` 技能根据仓库实际情况生成，请勿手动覆盖自动生成的内容。
-
-## 项目定位
-
-<!-- 由 project-init 填写：项目名称、业务背景、核心功能定位 -->
-
-## 技术栈
-
-- 运行时：Node.js
-- 框架：NestJS
-- 语言：TypeScript
-- 构建：nest build / tsc
-
-## 核心模块
-
-<!-- 由 project-init 填写：主要 Module 列表及职责 -->
-
-## 主要依赖
-
-<!-- 由 project-init 根据 package.json 填写 -->
+---
+alwaysApply: false
+description: NestJS 项目概述，描述项目定位、技术栈、模块结构与核心依赖。当了解项目背景或进行整体规划时读取此规则。
+---
+
+# 项目概述（NestJS）
+
+> 本文件由 `project-init` 技能根据仓库实际情况生成，请勿手动覆盖自动生成的内容。
+
+## 项目定位
+
+<!-- 由 project-init 填写：项目名称、业务背景、核心功能定位 -->
+
+## 技术栈
+
+- 运行时：Node.js
+- 框架：NestJS
+- 语言：TypeScript
+- 构建：nest build / tsc
+
+## 核心模块
+
+<!-- 由 project-init 填写：主要 Module 列表及职责 -->
+
+## 主要依赖
+
+<!-- 由 project-init 根据 package.json 填写 -->

package/.agents/rules/profiles/nestjs/03-/351/241/271/347/233/256/347/273/223/346/236/204.md

@@ -1,20 +1,20 @@
----
-alwaysApply: false
-description: NestJS 项目目录结构规范，描述 src/ 模块组织、目录约定与文件命名规则。当新建模块、文件或理解项目结构时读取此规则。
----
-
-# 项目结构（NestJS）
-
-> 本文件由 `project-init` 技能根据仓库实际情况生成，请勿手动覆盖自动生成的内容。
-
-## 顶层目录
-
-<!-- 由 project-init 填写：根目录的主要目录及说明 -->
-
-## src/ 结构
-
-<!-- 由 project-init 填写：模块目录、通用目录（common/guards/filters/interceptors等）结构 -->
-
-## 文件命名约定
-
-<!-- 由 project-init 根据现有代码归纳：*.module.ts / *.controller.ts / *.service.ts / *.dto.ts 等 -->
+---
+alwaysApply: false
+description: NestJS 项目目录结构规范，描述 src/ 模块组织、目录约定与文件命名规则。当新建模块、文件或理解项目结构时读取此规则。
+---
+
+# 项目结构（NestJS）
+
+> 本文件由 `project-init` 技能根据仓库实际情况生成，请勿手动覆盖自动生成的内容。
+
+## 顶层目录
+
+<!-- 由 project-init 填写：根目录的主要目录及说明 -->
+
+## src/ 结构
+
+<!-- 由 project-init 填写：模块目录、通用目录（common/guards/filters/interceptors等）结构 -->
+
+## 文件命名约定
+
+<!-- 由 project-init 根据现有代码归纳：*.module.ts / *.controller.ts / *.service.ts / *.dto.ts 等 -->

package/.agents/rules/profiles/nestjs/04-/346/250/241/345/235/227/347/273/223/346/236/204/350/247/204/350/214/203.md

@@ -1,24 +1,24 @@
----
-alwaysApply: false
-description: NestJS 模块结构规范，约定 Module/Controller/Service/Provider 的职责边界、依赖注入方式与目录布局。当新建或重构模块时读取此规则。
----
-
-# 模块结构规范（NestJS）
-
-> 本文件由 `project-init` 技能根据仓库实际代码生成，请勿手动覆盖自动生成的内容。
-
-## Module 组织原则
-
-<!-- 由 project-init 填写：功能模块划分、全局模块、共享模块规范 -->
-
-## Controller 规范
-
-<!-- 由 project-init 填写：路由前缀、参数装饰器、响应格式约定 -->
-
-## Service 规范
-
-<!-- 由 project-init 填写：业务逻辑层职责、不允许直接操作数据库等约定 -->
-
-## DTO 与 Validation
-
-<!-- 由 project-init 填写：class-validator 用法、DTO 命名约定 -->
+---
+alwaysApply: false
+description: NestJS 模块结构规范，约定 Module/Controller/Service/Provider 的职责边界、依赖注入方式与目录布局。当新建或重构模块时读取此规则。
+---
+
+# 模块结构规范（NestJS）
+
+> 本文件由 `project-init` 技能根据仓库实际代码生成，请勿手动覆盖自动生成的内容。
+
+## Module 组织原则
+
+<!-- 由 project-init 填写：功能模块划分、全局模块、共享模块规范 -->
+
+## Controller 规范
+
+<!-- 由 project-init 填写：路由前缀、参数装饰器、响应格式约定 -->
+
+## Service 规范
+
+<!-- 由 project-init 填写：业务逻辑层职责、不允许直接操作数据库等约定 -->
+
+## DTO 与 Validation
+
+<!-- 由 project-init 填写：class-validator 用法、DTO 命名约定 -->

package/.agents/rules/profiles/nestjs/05-/346/216/245/345/217/243/344/270/216/345/245/221/347/272/246/350/247/204/350/214/203.md

@@ -1,24 +1,24 @@
----
-alwaysApply: false
-description: NestJS 接口与契约规范，约定 HTTP 方法、路由命名、请求/响应结构、版本管理与 Swagger 文档规范。当新建或修改接口时读取此规则。
----
-
-# 接口与契约规范（NestJS）
-
-> 本文件由 `project-init` 技能根据仓库实际代码生成，请勿手动覆盖自动生成的内容。
-
-## 路由命名约定
-
-<!-- 由 project-init 填写：RESTful 风格、路由前缀、版本号规范 -->
-
-## 请求/响应结构
-
-<!-- 由 project-init 填写：统一响应体格式（code/message/data）、分页结构等 -->
-
-## 错误码规范
-
-<!-- 由 project-init 填写：业务错误码、HTTP 状态码映射 -->
-
-## Swagger 文档
-
-<!-- 由 project-init 填写：@ApiTags/@ApiOperation 使用约定，是否必须注释 -->
+---
+alwaysApply: false
+description: NestJS 接口与契约规范，约定 HTTP 方法、路由命名、请求/响应结构、版本管理与 Swagger 文档规范。当新建或修改接口时读取此规则。
+---
+
+# 接口与契约规范（NestJS）
+
+> 本文件由 `project-init` 技能根据仓库实际代码生成，请勿手动覆盖自动生成的内容。
+
+## 路由命名约定
+
+<!-- 由 project-init 填写：RESTful 风格、路由前缀、版本号规范 -->
+
+## 请求/响应结构
+
+<!-- 由 project-init 填写：统一响应体格式（code/message/data）、分页结构等 -->
+
+## 错误码规范
+
+<!-- 由 project-init 填写：业务错误码、HTTP 状态码映射 -->
+
+## Swagger 文档
+
+<!-- 由 project-init 填写：@ApiTags/@ApiOperation 使用约定，是否必须注释 -->

package/.agents/rules/profiles/nestjs/06-/346/225/260/346/215/256/350/256/277/351/227/256/350/247/204/350/214/203.md

@@ -1,24 +1,24 @@
----
-alwaysApply: false
-description: NestJS 数据访问规范，约定 ORM/数据库客户端选型、Repository 层职责、事务处理与查询优化原则。当涉及数据库操作时读取此规则。
----
-
-# 数据访问规范（NestJS）
-
-> 本文件由 `project-init` 技能根据仓库实际代码生成，请勿手动覆盖自动生成的内容。
-
-## ORM/数据库选型
-
-<!-- 由 project-init 填写：TypeORM / Prisma / Mongoose 等，版本与配置位置 -->
-
-## Repository 模式
-
-<!-- 由 project-init 填写：自定义 Repository、是否使用 @InjectRepository、禁止在 Controller 直接操作 DB -->
-
-## 事务处理
-
-<!-- 由 project-init 填写：事务装饰器或手动事务用法 -->
-
-## 查询规范
-
-<!-- 由 project-init 填写：禁止 SELECT *、N+1 处理、软删除约定 -->
+---
+alwaysApply: false
+description: NestJS 数据访问规范，约定 ORM/数据库客户端选型、Repository 层职责、事务处理与查询优化原则。当涉及数据库操作时读取此规则。
+---
+
+# 数据访问规范（NestJS）
+
+> 本文件由 `project-init` 技能根据仓库实际代码生成，请勿手动覆盖自动生成的内容。
+
+## ORM/数据库选型
+
+<!-- 由 project-init 填写：TypeORM / Prisma / Mongoose 等，版本与配置位置 -->
+
+## Repository 模式
+
+<!-- 由 project-init 填写：自定义 Repository、是否使用 @InjectRepository、禁止在 Controller 直接操作 DB -->
+
+## 事务处理
+
+<!-- 由 project-init 填写：事务装饰器或手动事务用法 -->
+
+## 查询规范
+
+<!-- 由 project-init 填写：禁止 SELECT *、N+1 处理、软删除约定 -->