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

package/.agents/rules/profiles/nestjs/07-/351/205/215/347/275/256/344/270/216/350/277/220/350/241/214/346/227/266/350/247/204/350/214/203.md

@@ -1,20 +1,20 @@
----
-alwaysApply: false
-description: NestJS 配置与运行时规范，约定环境变量管理、ConfigModule 用法、启动参数与跨环境配置策略。当涉及配置项或环境变量时读取此规则。
----
-
-# 配置与运行时规范（NestJS）
-
-> 本文件由 `project-init` 技能根据仓库实际代码生成，请勿手动覆盖自动生成的内容。
-
-## 环境变量管理
-
-<!-- 由 project-init 填写：.env 文件约定、ConfigModule 配置、@nestjs/config 用法 -->
-
-## 运行时端口与启动参数
-
-<!-- 由 project-init 填写：端口配置位置、跨环境变量（dev/test/prod）切换方式 -->
-
-## 密钥与敏感配置
-
-<!-- 由 project-init 填写：禁止硬编码、密钥注入方式 -->
+---
+alwaysApply: false
+description: NestJS 配置与运行时规范，约定环境变量管理、ConfigModule 用法、启动参数与跨环境配置策略。当涉及配置项或环境变量时读取此规则。
+---
+
+# 配置与运行时规范（NestJS）
+
+> 本文件由 `project-init` 技能根据仓库实际代码生成，请勿手动覆盖自动生成的内容。
+
+## 环境变量管理
+
+<!-- 由 project-init 填写：.env 文件约定、ConfigModule 配置、@nestjs/config 用法 -->
+
+## 运行时端口与启动参数
+
+<!-- 由 project-init 填写：端口配置位置、跨环境变量（dev/test/prod）切换方式 -->
+
+## 密钥与敏感配置
+
+<!-- 由 project-init 填写：禁止硬编码、密钥注入方式 -->

package/.agents/rules/profiles/nestjs/09-/345/274/202/345/270/270/344/270/216/346/227/245/345/277/227/350/247/204/350/214/203.md

@@ -1,20 +1,20 @@
----
-alwaysApply: false
-description: NestJS 异常与日志规范，约定全局异常过滤器、业务异常类型、日志级别与结构化日志输出方式。当编写错误处理或日志相关代码时读取此规则。
----
-
-# 异常与日志规范（NestJS）
-
-> 本文件由 `project-init` 技能根据仓库实际代码生成，请勿手动覆盖自动生成的内容。
-
-## 全局异常过滤器
-
-<!-- 由 project-init 填写：HttpExceptionFilter 实现位置、是否统一包装错误响应 -->
-
-## 业务异常类型
-
-<!-- 由 project-init 填写：自定义 BusinessException、错误码枚举 -->
-
-## 日志规范
-
-<!-- 由 project-init 填写：Logger 注入方式、日志级别约定、结构化日志字段（traceId 等） -->
+---
+alwaysApply: false
+description: NestJS 异常与日志规范，约定全局异常过滤器、业务异常类型、日志级别与结构化日志输出方式。当编写错误处理或日志相关代码时读取此规则。
+---
+
+# 异常与日志规范（NestJS）
+
+> 本文件由 `project-init` 技能根据仓库实际代码生成，请勿手动覆盖自动生成的内容。
+
+## 全局异常过滤器
+
+<!-- 由 project-init 填写：HttpExceptionFilter 实现位置、是否统一包装错误响应 -->
+
+## 业务异常类型
+
+<!-- 由 project-init 填写：自定义 BusinessException、错误码枚举 -->
+
+## 日志规范
+
+<!-- 由 project-init 填写：Logger 注入方式、日志级别约定、结构化日志字段（traceId 等） -->

package/.agents/rules/profiles/nestjs/11-/346/265/213/350/257/225/350/247/204/350/214/203.md

@@ -1,24 +1,24 @@
----
-alwaysApply: false
-description: NestJS 测试规范，约定单元测试、e2e 测试的组织方式、Mock 策略与覆盖率要求。当编写或审查测试时读取此规则。
----
-
-# 测试规范（NestJS）
-
-> 本文件由 `project-init` 技能根据仓库实际代码生成，请勿手动覆盖自动生成的内容。
-
-## 测试框架
-
-<!-- 由 project-init 填写：Jest 配置位置、测试脚本命令 -->
-
-## 单元测试规范
-
-<!-- 由 project-init 填写：*.spec.ts 命名约定、TestingModule 初始化、Mock 策略 -->
-
-## e2e 测试规范
-
-<!-- 由 project-init 填写：test/ 目录结构、supertest 用法、测试数据库策略 -->
-
-## 覆盖率要求
-
-<!-- 由 project-init 填写：覆盖率阈值、需覆盖的核心模块范围 -->
+---
+alwaysApply: false
+description: NestJS 测试规范，约定单元测试、e2e 测试的组织方式、Mock 策略与覆盖率要求。当编写或审查测试时读取此规则。
+---
+
+# 测试规范（NestJS）
+
+> 本文件由 `project-init` 技能根据仓库实际代码生成，请勿手动覆盖自动生成的内容。
+
+## 测试框架
+
+<!-- 由 project-init 填写：Jest 配置位置、测试脚本命令 -->
+
+## 单元测试规范
+
+<!-- 由 project-init 填写：*.spec.ts 命名约定、TestingModule 初始化、Mock 策略 -->
+
+## e2e 测试规范
+
+<!-- 由 project-init 填写：test/ 目录结构、supertest 用法、测试数据库策略 -->
+
+## 覆盖率要求
+
+<!-- 由 project-init 填写：覆盖率阈值、需覆盖的核心模块范围 -->

package/.agents/rules/profiles/nestjs/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md

@@ -1,20 +1,20 @@
----
-alwaysApply: false
-description: NestJS 代码格式化与检查规范，约定 ESLint/Prettier 配置位置、规则集与提交前检查流程。当配置或运行代码检查时读取此规则。
----
-
-# 代码格式化与检查（NestJS）
-
-> 本文件由 `project-init` 技能根据仓库实际代码生成，请勿手动覆盖自动生成的内容。
-
-## ESLint 配置
-
-<!-- 由 project-init 填写：配置文件位置、使用的规则集（@typescript-eslint 等）、关键自定义规则 -->
-
-## Prettier 配置
-
-<!-- 由 project-init 填写：配置文件位置、主要格式选项 -->
-
-## 提交前检查
-
-<!-- 由 project-init 填写：lint-staged 配置、husky hooks、CI lint 步骤 -->
+---
+alwaysApply: false
+description: NestJS 代码格式化与检查规范，约定 ESLint/Prettier 配置位置、规则集与提交前检查流程。当配置或运行代码检查时读取此规则。
+---
+
+# 代码格式化与检查（NestJS）
+
+> 本文件由 `project-init` 技能根据仓库实际代码生成，请勿手动覆盖自动生成的内容。
+
+## ESLint 配置
+
+<!-- 由 project-init 填写：配置文件位置、使用的规则集（@typescript-eslint 等）、关键自定义规则 -->
+
+## Prettier 配置
+
+<!-- 由 project-init 填写：配置文件位置、主要格式选项 -->
+
+## 提交前检查
+
+<!-- 由 project-init 填写：lint-staged 配置、husky hooks、CI lint 步骤 -->

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

@@ -1,30 +1,30 @@
----
-alwaysApply: false
-description: Node.js 工具仓项目概述，描述项目定位、技术栈、主要模块与运行入口。当了解项目背景或进行整体规划时读取此规则。
----
-
-# 项目概述（Node.js Tooling）
-
-> 本文件由 `project-init` 技能根据仓库实际情况生成，请勿手动覆盖自动生成的内容。
-
-## 项目定位
-
-<!-- 描述项目的工具定位：CLI 工具 / Worker / 编排运行时 / Contract 验证工具 等 -->
-
-## 技术栈
-
-| 层次 | 技术 |
-|------|------|
-| 运行时 | Node.js（版本见 `.nvmrc` 或 `engines` 字段） |
-| 语言 | TypeScript / JavaScript |
-| 包管理 | npm / pnpm / yarn（项目统一约定） |
-| 测试框架 | Vitest / Jest |
-| Schema 校验 | Zod / Ajv / io-ts（按需） |
-
-## 主要模块
-
-<!-- 描述仓库内的主要模块/子包结构 -->
-
-## 运行入口
-
-<!-- 描述 CLI 入口、worker 入口、主模块导出等 -->
+---
+alwaysApply: false
+description: Node.js 工具仓项目概述，描述项目定位、技术栈、主要模块与运行入口。当了解项目背景或进行整体规划时读取此规则。
+---
+
+# 项目概述（Node.js Tooling）
+
+> 本文件由 `project-init` 技能根据仓库实际情况生成，请勿手动覆盖自动生成的内容。
+
+## 项目定位
+
+<!-- 描述项目的工具定位：CLI 工具 / Worker / 编排运行时 / Contract 验证工具 等 -->
+
+## 技术栈
+
+| 层次 | 技术 |
+|------|------|
+| 运行时 | Node.js（版本见 `.nvmrc` 或 `engines` 字段） |
+| 语言 | TypeScript / JavaScript |
+| 包管理 | npm / pnpm / yarn（项目统一约定） |
+| 测试框架 | Vitest / Jest |
+| Schema 校验 | Zod / Ajv / io-ts（按需） |
+
+## 主要模块
+
+<!-- 描述仓库内的主要模块/子包结构 -->
+
+## 运行入口
+
+<!-- 描述 CLI 入口、worker 入口、主模块导出等 -->

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

@@ -1,37 +1,37 @@
----
-alwaysApply: false
-description: Node.js 工具仓项目结构规范，包括目录组织、模块边界约定与主要入口文件规则。当新建模块或文件时读取此规则。
----
-
-# 项目结构（Node.js Tooling）
-
-> 本文件由 `project-init` 技能根据仓库实际情况生成，请勿手动覆盖自动生成的内容。
-
-## 典型目录结构
-
-```text
-<root>/
-├── src/
-│   ├── cli/           # CLI 命令定义与入口
-│   ├── commands/      # 各子命令实现
-│   ├── contracts/     # Contract / Schema 定义
-│   ├── workers/       # Worker 任务实现
-│   ├── runtime/       # 运行时核心逻辑
-│   ├── utils/         # 通用工具函数
-│   └── types/         # TypeScript 类型定义
-├── tests/             # 测试文件
-├── scripts/           # 构建、发布等脚本
-├── package.json
-└── tsconfig.json
-```
-
-## 模块边界约定
-
-- 每个模块（`cli/`、`workers/`、`contracts/` 等）对外只导出必要接口
-- 模块内部实现不应被外部直接引用
-- 禁止循环依赖
-
-## 入口文件规则
-
-- CLI 入口在 `src/cli/index.ts`（或 `bin/` 下）
-- 库入口在 `src/index.ts`，并在 `package.json` 中声明 `main` / `exports`
+---
+alwaysApply: false
+description: Node.js 工具仓项目结构规范，包括目录组织、模块边界约定与主要入口文件规则。当新建模块或文件时读取此规则。
+---
+
+# 项目结构（Node.js Tooling）
+
+> 本文件由 `project-init` 技能根据仓库实际情况生成，请勿手动覆盖自动生成的内容。
+
+## 典型目录结构
+
+```text
+<root>/
+├── src/
+│   ├── cli/           # CLI 命令定义与入口
+│   ├── commands/      # 各子命令实现
+│   ├── contracts/     # Contract / Schema 定义
+│   ├── workers/       # Worker 任务实现
+│   ├── runtime/       # 运行时核心逻辑
+│   ├── utils/         # 通用工具函数
+│   └── types/         # TypeScript 类型定义
+├── tests/             # 测试文件
+├── scripts/           # 构建、发布等脚本
+├── package.json
+└── tsconfig.json
+```
+
+## 模块边界约定
+
+- 每个模块（`cli/`、`workers/`、`contracts/` 等）对外只导出必要接口
+- 模块内部实现不应被外部直接引用
+- 禁止循环依赖
+
+## 入口文件规则
+
+- CLI 入口在 `src/cli/index.ts`（或 `bin/` 下）
+- 库入口在 `src/index.ts`，并在 `package.json` 中声明 `main` / `exports`

package/.agents/rules/profiles/node-tooling/04-CLI/344/270/216/346/250/241/345/235/227/350/247/204/350/214/203.md

@@ -1,42 +1,42 @@
----
-alwaysApply: false
-description: Node.js 工具仓的 CLI 与模块规范，包括命令定义方式、参数约定、模块导出规则。当新增 CLI 命令或模块时读取此规则。
----
-
-# CLI 与模块规范（Node.js Tooling）
-
-## CLI 命令设计
-
-- 使用团队约定的 CLI 框架（如 `commander`、`yargs`、`meow`）
-- 每个子命令对应独立文件，命令描述必须清晰
-- 命令参数使用 `--kebab-case` 风格
-- 所有命令必须提供 `--help` 说明
-
-```typescript
-// 示例：commander 风格
-program
-  .command('run <task>')
-  .description('执行指定任务')
-  .option('--dry-run', '仅预览，不实际执行')
-  .action(async (task, options) => {
-    await runTask(task, options);
-  });
-```
-
-## 模块导出规则（NON-NEGOTIABLE）
-
-- 每个模块在 `index.ts` 中统一导出公共接口
-- 内部实现文件不应从模块外直接引用
-- 导出的函数和类必须有明确的 TypeScript 类型签名
-- 发布到 npm 的包必须在 `package.json` 中声明 `exports` 字段
-
-## 异步处理
-
-- 优先使用 `async/await`，避免 callback 嵌套
-- 所有异步操作必须处理错误（try/catch 或 `.catch()`）
-- 长时间运行的操作需提供超时机制
-
-## 进程管理
-
-- 正常退出使用 `process.exit(0)`，错误退出使用 `process.exit(1)`
-- 监听 `SIGINT`、`SIGTERM` 信号，进行优雅退出处理
+---
+alwaysApply: false
+description: Node.js 工具仓的 CLI 与模块规范，包括命令定义方式、参数约定、模块导出规则。当新增 CLI 命令或模块时读取此规则。
+---
+
+# CLI 与模块规范（Node.js Tooling）
+
+## CLI 命令设计
+
+- 使用团队约定的 CLI 框架（如 `commander`、`yargs`、`meow`）
+- 每个子命令对应独立文件，命令描述必须清晰
+- 命令参数使用 `--kebab-case` 风格
+- 所有命令必须提供 `--help` 说明
+
+```typescript
+// 示例：commander 风格
+program
+  .command('run <task>')
+  .description('执行指定任务')
+  .option('--dry-run', '仅预览，不实际执行')
+  .action(async (task, options) => {
+    await runTask(task, options);
+  });
+```
+
+## 模块导出规则（NON-NEGOTIABLE）
+
+- 每个模块在 `index.ts` 中统一导出公共接口
+- 内部实现文件不应从模块外直接引用
+- 导出的函数和类必须有明确的 TypeScript 类型签名
+- 发布到 npm 的包必须在 `package.json` 中声明 `exports` 字段
+
+## 异步处理
+
+- 优先使用 `async/await`，避免 callback 嵌套
+- 所有异步操作必须处理错误（try/catch 或 `.catch()`）
+- 长时间运行的操作需提供超时机制
+
+## 进程管理
+
+- 正常退出使用 `process.exit(0)`，错误退出使用 `process.exit(1)`
+- 监听 `SIGINT`、`SIGTERM` 信号，进行优雅退出处理

package/.agents/rules/profiles/node-tooling/05-Contract/344/270/216Schema/350/247/204/350/214/203.md

@@ -1,42 +1,42 @@
----
-alwaysApply: false
-description: Node.js 工具仓的 Contract 与 Schema 规范，包括 Schema 定义方式、Contract 校验策略与类型导出约定。当新增或修改 Contract / Schema 时读取此规则。
----
-
-# Contract 与 Schema 规范（Node.js Tooling）
-
-## Schema 定义
-
-- 统一使用项目约定的 Schema 库（Zod / Ajv / io-ts）定义数据结构
-- Schema 文件放在 `src/contracts/` 或 `src/schemas/` 目录
-- 每个 Schema 对应独立文件，按业务领域命名
-
-```typescript
-// 示例：Zod Schema
-import { z } from 'zod';
-
-export const TaskPayloadSchema = z.object({
-  taskId: z.string().uuid(),
-  type: z.enum(['build', 'deploy', 'test']),
-  params: z.record(z.unknown()),
-});
-
-export type TaskPayload = z.infer<typeof TaskPayloadSchema>;
-```
-
-## Contract 校验策略（NON-NEGOTIABLE）
-
-- 所有外部输入（CLI 参数、API 响应、消息队列消息、文件内容）在入口处必须校验
-- 校验失败必须给出明确的错误信息（字段路径 + 错误原因）
-- 禁止使用 `as any` 绕过类型校验
-
-## 类型导出约定
-
-- Schema 推导出的 TypeScript 类型必须一并导出（`export type`）
-- 类型名称与 Schema 名称保持对应（`TaskPayloadSchema` → `TaskPayload`）
-- 禁止手动维护与 Schema 重复的类型定义
-
-## 版本兼容性
-
-- Contract 发生破坏性变更时，需同步更新版本号并提供迁移说明
-- 向前兼容的变更（新增可选字段）无需升级大版本
+---
+alwaysApply: false
+description: Node.js 工具仓的 Contract 与 Schema 规范，包括 Schema 定义方式、Contract 校验策略与类型导出约定。当新增或修改 Contract / Schema 时读取此规则。
+---
+
+# Contract 与 Schema 规范（Node.js Tooling）
+
+## Schema 定义
+
+- 统一使用项目约定的 Schema 库（Zod / Ajv / io-ts）定义数据结构
+- Schema 文件放在 `src/contracts/` 或 `src/schemas/` 目录
+- 每个 Schema 对应独立文件，按业务领域命名
+
+```typescript
+// 示例：Zod Schema
+import { z } from 'zod';
+
+export const TaskPayloadSchema = z.object({
+  taskId: z.string().uuid(),
+  type: z.enum(['build', 'deploy', 'test']),
+  params: z.record(z.unknown()),
+});
+
+export type TaskPayload = z.infer<typeof TaskPayloadSchema>;
+```
+
+## Contract 校验策略（NON-NEGOTIABLE）
+
+- 所有外部输入（CLI 参数、API 响应、消息队列消息、文件内容）在入口处必须校验
+- 校验失败必须给出明确的错误信息（字段路径 + 错误原因）
+- 禁止使用 `as any` 绕过类型校验
+
+## 类型导出约定
+
+- Schema 推导出的 TypeScript 类型必须一并导出（`export type`）
+- 类型名称与 Schema 名称保持对应（`TaskPayloadSchema` → `TaskPayload`）
+- 禁止手动维护与 Schema 重复的类型定义
+
+## 版本兼容性
+
+- Contract 发生破坏性变更时，需同步更新版本号并提供迁移说明
+- 向前兼容的变更（新增可选字段）无需升级大版本

package/.agents/rules/profiles/node-tooling/06-/350/277/220/350/241/214/346/227/266/346/226/207/344/273/266/350/247/204/350/214/203.md

@@ -1,30 +1,30 @@
----
-alwaysApply: false
-description: Node.js 工具仓的运行时文件规范，包括工作目录管理、临时文件约定、状态文件读写策略。当涉及文件系统操作时读取此规则。
----
-
-# 运行时文件规范（Node.js Tooling）
-
-## 工作目录管理
-
-- 使用 `process.cwd()` 获取当前工作目录，禁止使用 `__dirname` 做运行时路径拼接（ESM 模块下不可用）
-- ESM 环境下使用 `new URL(import.meta.url)` 获取当前文件路径
-- 跨平台路径拼接统一使用 `node:path` 的 `join` / `resolve`
-
-## 临时文件约定
-
-- 临时文件写入系统临时目录（`os.tmpdir()`）或项目约定的 `.tmp/` 目录
-- 临时目录加入 `.gitignore`
-- 程序异常退出时，应通过 `process.on('exit')` 或 `finally` 块清理临时文件
-
-## 状态文件读写
-
-- 运行时状态文件（锁文件、任务状态、中间产物）统一放在项目约定目录（如 `.run/`、`.state/`）
-- 读写状态文件前检查权限，写失败需给出明确错误提示
-- 状态文件格式统一使用 JSON，禁止使用自定义二进制格式
-
-## 文件监听
-
-- 使用 `node:fs/promises` 或 `chokidar` 进行文件监听
-- 监听器必须在程序退出时显式关闭，防止进程无法退出
-- 大量文件监听需评估系统 `inotify` 上限
+---
+alwaysApply: false
+description: Node.js 工具仓的运行时文件规范，包括工作目录管理、临时文件约定、状态文件读写策略。当涉及文件系统操作时读取此规则。
+---
+
+# 运行时文件规范（Node.js Tooling）
+
+## 工作目录管理
+
+- 使用 `process.cwd()` 获取当前工作目录，禁止使用 `__dirname` 做运行时路径拼接（ESM 模块下不可用）
+- ESM 环境下使用 `new URL(import.meta.url)` 获取当前文件路径
+- 跨平台路径拼接统一使用 `node:path` 的 `join` / `resolve`
+
+## 临时文件约定
+
+- 临时文件写入系统临时目录（`os.tmpdir()`）或项目约定的 `.tmp/` 目录
+- 临时目录加入 `.gitignore`
+- 程序异常退出时，应通过 `process.on('exit')` 或 `finally` 块清理临时文件
+
+## 状态文件读写
+
+- 运行时状态文件（锁文件、任务状态、中间产物）统一放在项目约定目录（如 `.run/`、`.state/`）
+- 读写状态文件前检查权限，写失败需给出明确错误提示
+- 状态文件格式统一使用 JSON，禁止使用自定义二进制格式
+
+## 文件监听
+
+- 使用 `node:fs/promises` 或 `chokidar` 进行文件监听
+- 监听器必须在程序退出时显式关闭，防止进程无法退出
+- 大量文件监听需评估系统 `inotify` 上限