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

package/.agents/rules/profiles/node-tooling/07-/346/227/245/345/277/227/344/270/216/351/224/231/350/257/257/345/244/204/347/220/206/350/247/204/350/214/203.md

@@ -1,60 +1,60 @@
----
-alwaysApply: false
-description: Node.js 工具仓的日志与错误处理规范，包括日志工具选型、结构化日志约定、错误类型定义与进程崩溃处理。当编写日志或错误处理代码时读取此规则。
----
-
-# 日志与错误处理规范（Node.js Tooling）
-
-## 日志工具
-
-- 统一使用项目约定的日志库（如 `pino`、`winston`、`consola`）
-- 禁止直接使用 `console.log` 在生产逻辑中输出日志
-- 开发模式下允许彩色格式化输出，生产模式使用结构化 JSON 日志
-
-## 日志级别
-
-| 级别 | 使用场景 |
-|------|----------|
-| error | 不可恢复错误、进程崩溃 |
-| warn | 可恢复的异常、降级处理 |
-| info | 关键操作节点（任务开始/结束、关键状态变化） |
-| debug | 调试信息，生产关闭 |
-
-## 结构化日志字段
-
-关键操作日志应包含：
-
-```json
-{
-  "level": "info",
-  "time": "ISO-8601",
-  "taskId": "xxx",
-  "event": "task.completed",
-  "duration": 1234,
-  "result": "success"
-}
-```
-
-## 错误类型定义
-
-- 定义统一的错误基类（如 `ToolingError`）
-- 不同场景使用有语义的子类（如 `ValidationError`、`ContractMismatchError`、`TimeoutError`）
-- 禁止直接抛出 `new Error('some message')`，必须使用有类型的错误类
-
-```typescript
-export class ValidationError extends Error {
-  constructor(
-    message: string,
-    public readonly field?: string
-  ) {
-    super(message);
-    this.name = 'ValidationError';
-  }
-}
-```
-
-## 全局错误处理（NON-NEGOTIABLE）
-
-- 监听 `process.on('uncaughtException')` 和 `process.on('unhandledRejection')`，记录错误后以非零退出码退出
-- Promise 链中的 rejection 不允许静默忽略
-- async 函数中的错误必须在调用处捕获或向上传递
+---
+alwaysApply: false
+description: Node.js 工具仓的日志与错误处理规范，包括日志工具选型、结构化日志约定、错误类型定义与进程崩溃处理。当编写日志或错误处理代码时读取此规则。
+---
+
+# 日志与错误处理规范（Node.js Tooling）
+
+## 日志工具
+
+- 统一使用项目约定的日志库（如 `pino`、`winston`、`consola`）
+- 禁止直接使用 `console.log` 在生产逻辑中输出日志
+- 开发模式下允许彩色格式化输出，生产模式使用结构化 JSON 日志
+
+## 日志级别
+
+| 级别 | 使用场景 |
+|------|----------|
+| error | 不可恢复错误、进程崩溃 |
+| warn | 可恢复的异常、降级处理 |
+| info | 关键操作节点（任务开始/结束、关键状态变化） |
+| debug | 调试信息，生产关闭 |
+
+## 结构化日志字段
+
+关键操作日志应包含：
+
+```json
+{
+  "level": "info",
+  "time": "ISO-8601",
+  "taskId": "xxx",
+  "event": "task.completed",
+  "duration": 1234,
+  "result": "success"
+}
+```
+
+## 错误类型定义
+
+- 定义统一的错误基类（如 `ToolingError`）
+- 不同场景使用有语义的子类（如 `ValidationError`、`ContractMismatchError`、`TimeoutError`）
+- 禁止直接抛出 `new Error('some message')`，必须使用有类型的错误类
+
+```typescript
+export class ValidationError extends Error {
+  constructor(
+    message: string,
+    public readonly field?: string
+  ) {
+    super(message);
+    this.name = 'ValidationError';
+  }
+}
+```
+
+## 全局错误处理（NON-NEGOTIABLE）
+
+- 监听 `process.on('uncaughtException')` 和 `process.on('unhandledRejection')`，记录错误后以非零退出码退出
+- Promise 链中的 rejection 不允许静默忽略
+- async 函数中的错误必须在调用处捕获或向上传递

package/.agents/rules/profiles/node-tooling/09-/350/204/232/346/234/254/344/270/216/345/205/245/345/217/243/350/247/204/350/214/203.md

@@ -1,45 +1,45 @@
----
-alwaysApply: false
-description: Node.js 工具仓的脚本与入口规范，包括 package.json scripts 约定、bin 入口配置、构建产物结构与发布规则。当新增脚本入口或准备发布时读取此规则。
----
-
-# 脚本与入口规范（Node.js Tooling）
-
-## package.json scripts 约定
-
-| 脚本 | 职责 |
-|------|------|
-| `start` | 启动主程序（生产模式） |
-| `dev` | 开发模式（watch + ts-node / tsx） |
-| `build` | 编译 TypeScript 到 `dist/` |
-| `test` | 运行所有测试 |
-| `test:watch` | 监听模式运行测试 |
-| `lint` | 执行 ESLint 检查 |
-| `format` | 执行 Prettier 格式化 |
-| `typecheck` | 执行 `tsc --noEmit` 类型检查 |
-
-## bin 入口配置
-
-- CLI 工具在 `package.json` 中声明 `bin` 字段
-- 入口文件首行必须包含 shebang：`#!/usr/bin/env node`
-- bin 文件需设置可执行权限（`chmod +x`）
-
-```json
-{
-  "bin": {
-    "my-tool": "./dist/cli/index.js"
-  }
-}
-```
-
-## 构建产物结构
-
-- TypeScript 编译产物输出到 `dist/`，源码不直接发布
-- `package.json` 的 `main` / `exports` 指向 `dist/` 内文件
-- 确保 `.d.ts` 类型文件随产物一同输出（`declaration: true`）
-
-## 发布规则
-
-- 发布前必须执行 `typecheck`、`lint` 和 `test`，全部通过才能发布
-- 使用语义化版本（SemVer）：破坏性变更升大版本，新功能升小版本，修复升补丁版本
-- 在 `package.json` 的 `files` 字段中明确声明发布内容，禁止发布源码目录（`src/`）
+---
+alwaysApply: false
+description: Node.js 工具仓的脚本与入口规范，包括 package.json scripts 约定、bin 入口配置、构建产物结构与发布规则。当新增脚本入口或准备发布时读取此规则。
+---
+
+# 脚本与入口规范（Node.js Tooling）
+
+## package.json scripts 约定
+
+| 脚本 | 职责 |
+|------|------|
+| `start` | 启动主程序（生产模式） |
+| `dev` | 开发模式（watch + ts-node / tsx） |
+| `build` | 编译 TypeScript 到 `dist/` |
+| `test` | 运行所有测试 |
+| `test:watch` | 监听模式运行测试 |
+| `lint` | 执行 ESLint 检查 |
+| `format` | 执行 Prettier 格式化 |
+| `typecheck` | 执行 `tsc --noEmit` 类型检查 |
+
+## bin 入口配置
+
+- CLI 工具在 `package.json` 中声明 `bin` 字段
+- 入口文件首行必须包含 shebang：`#!/usr/bin/env node`
+- bin 文件需设置可执行权限（`chmod +x`）
+
+```json
+{
+  "bin": {
+    "my-tool": "./dist/cli/index.js"
+  }
+}
+```
+
+## 构建产物结构
+
+- TypeScript 编译产物输出到 `dist/`，源码不直接发布
+- `package.json` 的 `main` / `exports` 指向 `dist/` 内文件
+- 确保 `.d.ts` 类型文件随产物一同输出（`declaration: true`）
+
+## 发布规则
+
+- 发布前必须执行 `typecheck`、`lint` 和 `test`，全部通过才能发布
+- 使用语义化版本（SemVer）：破坏性变更升大版本，新功能升小版本，修复升补丁版本
+- 在 `package.json` 的 `files` 字段中明确声明发布内容，禁止发布源码目录（`src/`）

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

@@ -1,41 +1,41 @@
----
-alwaysApply: false
-description: Node.js 工具仓的测试规范，包括测试框架（Vitest / Jest）、测试文件约定、Mock 策略与质量门禁。当编写测试或评审测试代码时读取此规则。
----
-
-# 测试规范（Node.js Tooling）
-
-## 测试框架
-
-- 统一使用 **Vitest**（推荐）或 **Jest** 作为测试运行器
-- 类型检查：测试文件同样经过 TypeScript 编译，禁止 `@ts-ignore` 绕过类型问题
-
-## 测试文件约定
-
-| 项目 | 约定 |
-|------|------|
-| 文件位置 | 与源文件同目录 或 `tests/` 目录下 |
-| 文件命名 | `<name>.test.ts` / `<name>.spec.ts` |
-| 集成测试 | `<name>.integration.test.ts` |
-| 测试配置 | 项目根目录 `vitest.config.ts` 或 `jest.config.ts` |
-
-## Mock 策略
-
-- 使用 `vi.mock()` / `jest.mock()` Mock 外部模块（文件系统、网络请求、子进程等）
-- 不 Mock 被测模块内部实现
-- 临时文件操作测试中使用 `os.tmpdir()` + 随机子目录，测试后清理
-
-## 测试范围
-
-| 层次 | 说明 | 要求 |
-|------|------|------|
-| 必须测试 | 工具函数、Contract 校验、CLI 命令逻辑、Worker 任务处理 | 新增时必须附带测试 |
-| 建议测试 | CLI 参数解析、文件 I/O 流程 | 核心路径推荐覆盖 |
-| 集成测试 | 端到端执行流程 | 按需添加，标记 `integration` |
-
-## 质量门禁（NON-NEGOTIABLE）
-
-- 必须通过 **`tsc --noEmit`** 类型检查
-- 所有项目必须通过 **ESLint 检查**（零 error）
-- 新增工具函数、Contract 校验逻辑必须附带测试用例
-- 测试必须能独立运行，不依赖特定环境或执行顺序
+---
+alwaysApply: false
+description: Node.js 工具仓的测试规范，包括测试框架（Vitest / Jest）、测试文件约定、Mock 策略与质量门禁。当编写测试或评审测试代码时读取此规则。
+---
+
+# 测试规范（Node.js Tooling）
+
+## 测试框架
+
+- 统一使用 **Vitest**（推荐）或 **Jest** 作为测试运行器
+- 类型检查：测试文件同样经过 TypeScript 编译，禁止 `@ts-ignore` 绕过类型问题
+
+## 测试文件约定
+
+| 项目 | 约定 |
+|------|------|
+| 文件位置 | 与源文件同目录 或 `tests/` 目录下 |
+| 文件命名 | `<name>.test.ts` / `<name>.spec.ts` |
+| 集成测试 | `<name>.integration.test.ts` |
+| 测试配置 | 项目根目录 `vitest.config.ts` 或 `jest.config.ts` |
+
+## Mock 策略
+
+- 使用 `vi.mock()` / `jest.mock()` Mock 外部模块（文件系统、网络请求、子进程等）
+- 不 Mock 被测模块内部实现
+- 临时文件操作测试中使用 `os.tmpdir()` + 随机子目录，测试后清理
+
+## 测试范围
+
+| 层次 | 说明 | 要求 |
+|------|------|------|
+| 必须测试 | 工具函数、Contract 校验、CLI 命令逻辑、Worker 任务处理 | 新增时必须附带测试 |
+| 建议测试 | CLI 参数解析、文件 I/O 流程 | 核心路径推荐覆盖 |
+| 集成测试 | 端到端执行流程 | 按需添加，标记 `integration` |
+
+## 质量门禁（NON-NEGOTIABLE）
+
+- 必须通过 **`tsc --noEmit`** 类型检查
+- 所有项目必须通过 **ESLint 检查**（零 error）
+- 新增工具函数、Contract 校验逻辑必须附带测试用例
+- 测试必须能独立运行，不依赖特定环境或执行顺序

package/.agents/rules/profiles/node-tooling/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,55 +1,55 @@
----
-alwaysApply: false
-description: Node.js 工具仓的代码格式化与静态检查规范，包括 ESLint、Prettier 的工具链职责、配置约定与开发流程集成。当配置或调整 lint/format 工具时读取此规则。
----
-
-# 代码格式化与检查（Node.js Tooling）
-
-## 工具链
-
-| 工具 | 职责 | 配置文件 |
-|------|------|----------|
-| **Prettier** | 代码格式化（缩进、引号、分号等） | `.prettierrc.json` |
-| **ESLint** | 代码质量与风格检查 | `eslint.config.js` / `.eslintrc.cjs` |
-
-## Prettier 规则
-
-| 配置项 | 值 | 说明 |
-|--------|-----|------|
-| `semi` | `true` | 语句末尾加分号 |
-| `tabWidth` | `2` | 缩进 2 空格 |
-| `singleQuote` | `true` | 使用单引号 |
-| `printWidth` | `100` | 单行最大宽度 |
-| `trailingComma` | `"es5"` | 对象/数组末尾加逗号 |
-| `endOfLine` | `"auto"` | 自动适配换行符 |
-
-## ESLint 核心规则
-
-```js
-// eslint.config.js（ESLint 9 flat config）
-export default [
-  {
-    files: ['src/**/*.ts'],
-    rules: {
-      '@typescript-eslint/no-explicit-any': 'error',
-      '@typescript-eslint/no-unused-vars': 'error',
-      'no-console': ['error', { allow: ['warn', 'error'] }],
-    },
-  },
-];
-```
-
-## 开发流程集成
-
-### 提交前自动检查（husky + lint-staged）
-
-```json
-{
-  "*.{ts,js,json}": ["eslint --fix", "prettier --write"]
-}
-```
-
-### CI 集成
-
-- CI 流水线必须包含 `lint`、`typecheck`、`test` 三个检查步骤
-- 任一步骤失败则阻断 PR 合并
+---
+alwaysApply: false
+description: Node.js 工具仓的代码格式化与静态检查规范，包括 ESLint、Prettier 的工具链职责、配置约定与开发流程集成。当配置或调整 lint/format 工具时读取此规则。
+---
+
+# 代码格式化与检查（Node.js Tooling）
+
+## 工具链
+
+| 工具 | 职责 | 配置文件 |
+|------|------|----------|
+| **Prettier** | 代码格式化（缩进、引号、分号等） | `.prettierrc.json` |
+| **ESLint** | 代码质量与风格检查 | `eslint.config.js` / `.eslintrc.cjs` |
+
+## Prettier 规则
+
+| 配置项 | 值 | 说明 |
+|--------|-----|------|
+| `semi` | `true` | 语句末尾加分号 |
+| `tabWidth` | `2` | 缩进 2 空格 |
+| `singleQuote` | `true` | 使用单引号 |
+| `printWidth` | `100` | 单行最大宽度 |
+| `trailingComma` | `"es5"` | 对象/数组末尾加逗号 |
+| `endOfLine` | `"auto"` | 自动适配换行符 |
+
+## ESLint 核心规则
+
+```js
+// eslint.config.js（ESLint 9 flat config）
+export default [
+  {
+    files: ['src/**/*.ts'],
+    rules: {
+      '@typescript-eslint/no-explicit-any': 'error',
+      '@typescript-eslint/no-unused-vars': 'error',
+      'no-console': ['error', { allow: ['warn', 'error'] }],
+    },
+  },
+];
+```
+
+## 开发流程集成
+
+### 提交前自动检查（husky + lint-staged）
+
+```json
+{
+  "*.{ts,js,json}": ["eslint --fix", "prettier --write"]
+}
+```
+
+### CI 集成
+
+- CI 流水线必须包含 `lint`、`typecheck`、`test` 三个检查步骤
+- 任一步骤失败则阻断 PR 合并

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

@@ -1,29 +1,29 @@
----
-alwaysApply: false
-description: 项目定位与技术栈概览。当需要了解项目背景、使用的技术栈时读取此规则。
----
-
-# 项目概述
-
-## 项目定位
-
-一个基于 React + TypeScript 的单页应用（SPA）。
-
-> **与 JavaScript 存量项目的关系**：本文件默认描述团队推荐的 **React + TypeScript**。若 `package.json` 的 `dependencies` / `devDependencies` 中**未**声明 `typescript`，以「初始化项目规范」技能生成的 **01-项目概述.md** 为准，并遵循 **02-编码规范** 中的 JavaScript 小节。
-
-## 技术栈
-
-| 领域 | 技术 | 说明 |
-|------|------|------|
-| UI 框架 | React ^18.3.1 | 强制使用 |
-| 类型系统 | TypeScript 5.x | 推荐；新代码优先 TS。纯 JS 项目见 02-编码规范 |
-| 构建工具 | Vite 5.x | 通过 @shentu/cli 封装 |
-| 路由管理 | React Router ^6.30.2 | - |
-| 状态管理 | Zustand ^5.0.8 | Zustand（推荐）或 Redux，详见 07-状态管理 |
-| 组件库 | Ant Design 6.1.0+ | 所有交互 UI 必须基于 Antd 二次封装 |
-| 样式方案 | SCSS Modules, classnames | 强制使用，禁止全局样式 |
-| HTTP 请求 | @koi-design/vix-tools (request) | 统一请求封装，详见 05-API规范 |
-| 基础库 | @shentu/cli, @shentu/core | 脚手架与核心工具库 |
-| Hooks 工具 | ahooks 3.9.6 | 编写或封装 hooks 时，优先考虑是否有可使用的 ahooks |
-| 工具函数 | lodash-es 4.17.21 | 编写或封装 函数 时，优先考虑是否有可使用的 lodash 函数 |
-| 时间工具 | dayjs 1.11.19 | 涉及日期时间的处理统一用 dayjs |
+---
+alwaysApply: false
+description: 项目定位与技术栈概览。当需要了解项目背景、使用的技术栈时读取此规则。
+---
+
+# 项目概述
+
+## 项目定位
+
+一个基于 React + TypeScript 的单页应用（SPA）。
+
+> **与 JavaScript 存量项目的关系**：本文件默认描述团队推荐的 **React + TypeScript**。若 `package.json` 的 `dependencies` / `devDependencies` 中**未**声明 `typescript`，以「初始化项目规范」技能生成的 **01-项目概述.md** 为准，并遵循 **02-编码规范** 中的 JavaScript 小节。
+
+## 技术栈
+
+| 领域 | 技术 | 说明 |
+|------|------|------|
+| UI 框架 | React ^18.3.1 | 强制使用 |
+| 类型系统 | TypeScript 5.x | 推荐；新代码优先 TS。纯 JS 项目见 02-编码规范 |
+| 构建工具 | Vite 5.x | 通过 @shentu/cli 封装 |
+| 路由管理 | React Router ^6.30.2 | - |
+| 状态管理 | Zustand ^5.0.8 | Zustand（推荐）或 Redux，详见 07-状态管理 |
+| 组件库 | Ant Design 6.1.0+ | 所有交互 UI 必须基于 Antd 二次封装 |
+| 样式方案 | SCSS Modules, classnames | 强制使用，禁止全局样式 |
+| HTTP 请求 | @koi-design/vix-tools (request) | 统一请求封装，详见 05-API规范 |
+| 基础库 | @shentu/cli, @shentu/core | 脚手架与核心工具库 |
+| Hooks 工具 | ahooks 3.9.6 | 编写或封装 hooks 时，优先考虑是否有可使用的 ahooks |
+| 工具函数 | lodash-es 4.17.21 | 编写或封装 函数 时，优先考虑是否有可使用的 lodash 函数 |
+| 时间工具 | dayjs 1.11.19 | 涉及日期时间的处理统一用 dayjs |