@pigcloud/skills 1.0.11 → 1.1.2

package/skills/code-review/references/stack-notes.md

@@ -1,25 +0,0 @@
-# Code Review Stack Notes
-
-## Profile Scope
-
-- `code` is the generic review profile.
-- `code-java` is the Java / Spring / MyBatis / Pig Cloud overlay.
-- `code-vue` is the Vue 3 / frontend overlay.
-- `code-ts` is the TypeScript / frontend utility overlay.
-- Future stacks should add a new overlay instead of stretching `code`.
-
-## Mapping Hints
-
-- `*Entity.java` mainly covers entity and key conventions.
-- `*Controller.java` mainly covers controller, validation, and response contracts.
-- `*Service*.java` mainly covers service boundaries and transaction rules.
-- `*Mapper.java` mainly covers mapper logic and query shape.
-- `*DTO.java` / `*VO.java` mainly cover conversion boundaries.
-- `*.vue` mainly covers component boundaries and reactive flow.
-- `*.ts` / `*.tsx` mainly cover typed utilities, state modules, and config boundaries.
-
-## Review Rule
-
-- When a stack overlay applies, anchor the finding to the smallest stack-specific surface.
-- If the issue is generic, keep it in `code`.
-- If the issue is stack-specific, let the overlay own the first fix path.

package/skills/code-review/references/template-review.md

@@ -1,39 +0,0 @@
-# 代码审查报告模板
-
-> 代码审查结果的标准输出格式，用于保持结论清晰、可复核、可归档。
-
----
-
-## 基本信息
-
-| 字段 | 说明 |
-|------|------|
-| 审查时间 | {datetime} |
-| 审查对象 | {repo / branch / pr} |
-| 审查人 | {reviewer} |
-| 审查范围 | {diff / files / modules} |
-
-## 结论摘要
-
-- 总体结论：{pass / pass with comments / fail}
-- 风险等级：{low / medium / high}
-- 是否建议合并：{yes / no}
-
-## 发现项
-
-| 等级 | 文件 | 问题 | 建议 |
-|------|------|------|------|
-| P0 | {file} | {issue} | {fix} |
-| P1 | {file} | {issue} | {fix} |
-| P2 | {file} | {issue} | {fix} |
-
-## 验证信息
-
-- 已运行的检查：{lint / test / manual check}
-- 未覆盖的风险：{gaps}
-- 需要补充的证据：{evidence}
-
-## 备注
-
-- 如果没有发现问题，也要明确说明“未发现阻断项”。
-- 如果有假设，要明确标注假设来源。

package/skills/code-review/scripts/lint-code-review.mjs

@@ -1,431 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * lint-code-review.mjs - 零依赖代码审查 Lint 脚本
- * 
- * 用法:
- *   node lint-code-review.mjs --files <file-list>
- *   node lint-code-review.mjs --files <file-list> --json
- *   node lint-code-review.mjs --files <file-list> --quick
- * 
- * 输出:
- *   P0-P3 分级问题列表
- *   JSON 格式支持 CI 集成
- */
-
-import { readFileSync, existsSync, statSync } from 'fs';
-import { join, basename } from 'path';
-
-// 命令行参数解析
-const args = process.argv.slice(2);
-const options = {
-  files: [],
-  json: false,
-  quick: false
-};
-
-for (let i = 0; i < args.length; i++) {
-  if (args[i] === '--files') {
-    options.files = args[i + 1]?.split(',').filter(f => f) || [];
-    i++;
-  } else if (args[i] === '--json') {
-    options.json = true;
-  } else if (args[i] === '--quick') {
-    options.quick = true;
-  }
-}
-
-// 规则定义
-const RULES = {
-  // MUST 规则
-  'MUST-001': {
-    level: 'P1',
-    name: 'Entity 基类',
-    pattern: /class\s+\w+Entity\s+extends\s+/,
-    check: (content, filePath) => {
-      if (!filePath.includes('Entity')) return null;
-      if (!content.includes('MpRealDelEntity') && !content.includes('MpLogicDelEntity')) {
-        return {
-          message: 'Entity 未继承 MpRealDelEntity 或 MpLogicDelEntity',
-          fix: 'extends MpRealDelEntity<Entity>'
-        };
-      }
-      return null;
-    }
-  },
-  'MUST-002': {
-    level: 'P1',
-    name: '主键注解',
-    pattern: /@TableId/,
-    check: (content, filePath) => {
-      if (!filePath.includes('Entity')) return null;
-      if (content.includes('@TableId') && !content.includes('IdType.ASSIGN_ID')) {
-        return {
-          message: '主键未使用雪花算法',
-          fix: '@TableId(type = IdType.ASSIGN_ID)'
-        };
-      }
-      return null;
-    }
-  },
-  'MUST-004': {
-    level: 'P0',
-    name: '分层规范',
-    pattern: /@Autowired|@Resource/,
-    check: (content, filePath) => {
-      if (!filePath.includes('Controller')) return null;
-      // Controller 直接注入 Mapper
-      const mapperInject = content.match(/@(Autowired|Resource)\s*(private\s+)?(\w+Mapper)/);
-      if (mapperInject) {
-        const lineNum = getLineNumber(content, mapperInject[0]);
-        return {
-          line: lineNum,
-          message: 'Controller 直接注入 Mapper，违反分层规范',
-          code: mapperInject[0],
-          fix: '通过 Service 层访问数据'
-        };
-      }
-      return null;
-    }
-  },
-  'MUST-005': {
-    level: 'P1',
-    name: '返回规范',
-    pattern: /public\s+\w+\s+\w+\s*\(/,
-    check: (content, filePath) => {
-      if (!filePath.includes('Controller')) return null;
-      // 检查 REST 方法返回类型
-      const methods = content.matchAll(/@(GetMapping|PostMapping|PutMapping|DeleteMapping|RequestMapping)[\s\S]*?public\s+(\w+(?:<[^>]+>)?)\s+\w+\s*\(/g);
-      for (const method of methods) {
-        const returnType = method[2];
-        if (!returnType.includes('Result') && returnType !== 'void') {
-          const lineNum = getLineNumber(content, method[0]);
-          return {
-            line: lineNum,
-            message: `REST 方法返回类型应为 Result<T>，当前为 ${returnType}`,
-            fix: '返回 Result<T>'
-          };
-        }
-      }
-      return null;
-    }
-  },
-  'MUST-006': {
-    level: 'P1',
-    name: '事务注解',
-    pattern: /@Transactional/,
-    check: (content, filePath) => {
-      if (!filePath.includes('Service')) return null;
-      // 检查是否有跨表操作但无事务
-      const hasMultiTableOp = content.includes('insert') && content.includes('update') ||
-                               content.includes('insert') && content.includes('delete') ||
-                               content.includes('mapper') && content.includes('mapper');
-      if (hasMultiTableOp && !content.includes('@Transactional')) {
-        return {
-          message: '跨表操作未添加事务注解',
-          fix: '@Transactional(rollbackFor = Exception.class)'
-        };
-      }
-      return null;
-    }
-  },
-  
-  // NEVER 规则
-  'NEVER-001': {
-    level: 'P0',
-    name: 'Controller 直接访问 Mapper',
-    pattern: /Mapper\s+mapper/,
-    check: (content, filePath) => {
-      if (!filePath.includes('Controller')) return null;
-      const mapperRef = content.match(/(\w+Mapper)\s+\w+;/);
-      if (mapperRef) {
-        const lineNum = getLineNumber(content, mapperRef[0]);
-        return {
-          line: lineNum,
-          message: 'Controller 直接访问 Mapper',
-          code: mapperRef[0],
-          fix: '通过 Service 层访问'
-        };
-      }
-      return null;
-    }
-  },
-  'NEVER-002': {
-    level: 'P0',
-    name: '事务中远程调用',
-    pattern: /@Transactional[\s\S]*?(FeignClient|RestTemplate|HttpClient|WebClient)/,
-    check: (content, filePath) => {
-      if (!filePath.includes('Service')) return null;
-      // 检查事务方法中是否有远程调用
-      const transactionalBlock = content.match(/@Transactional[\s\S]{0,500}(?:@FeignClient|restTemplate|httpClient|webClient|\.api\()/);
-      if (transactionalBlock) {
-        const lineNum = getLineNumber(content, transactionalBlock[0]);
-        return {
-          line: lineNum,
-          message: '事务方法中执行远程调用',
-          fix: '将远程调用移到事务方法外部'
-        };
-      }
-      return null;
-    }
-  },
-  'NEVER-003': {
-    level: 'P1',
-    name: 'Mapper 业务逻辑',
-    pattern: /default\s+(void|Result|boolean)/,
-    check: (content, filePath) => {
-      if (!filePath.includes('Mapper')) return null;
-      // Mapper 中有 default 方法实现业务逻辑
-      const defaultMethod = content.match(/default\s+(?!class|interface)\w+\s+\w+\s*\([^)]*\)\s*\{[\s\S]{50,}/);
-      if (defaultMethod && !defaultMethod[0].includes('selectById') && !defaultMethod[0].includes('insert')) {
-        const lineNum = getLineNumber(content, defaultMethod[0]);
-        return {
-          line: lineNum,
-          message: 'Mapper 中放置业务逻辑',
-          fix: '将业务逻辑移到 Service 层'
-        };
-      }
-      return null;
-    }
-  },
-  'NEVER-004': {
-    level: 'P1',
-    name: 'String column names',
-    pattern: /\.eq\("|\.\s*like\("|\.\s*ne\("|\.\s*gt\("|\.\s*lt\("|\.\s*ge\("|\.\s*le\("/,
-    check: (content, filePath) => {
-      const stringColumn = content.match(/queryWrapper\.(?:eq|ne|gt|lt|ge|le|like)\s*\(\s*"/);
-      if (stringColumn) {
-        const lineNum = getLineNumber(content, stringColumn[0]);
-        return {
-          line: lineNum,
-          message: '使用 string column names 查询',
-          code: stringColumn[0],
-          fix: '使用 lambdaQuery().eq(Entity::getField, value)'
-        };
-      }
-      return null;
-    }
-  },
-  'NEVER-005': {
-    level: 'P2',
-    name: 'Left-fuzzy LIKE',
-    pattern: /\.like\("%|\.likeLeft\(/,
-    check: (content) => {
-      const leftFuzzy = content.match(/\.like\s*\(\s*["']%/);
-      if (leftFuzzy) {
-        const lineNum = getLineNumber(content, leftFuzzy[0]);
-        return {
-          line: lineNum,
-          message: '使用 left-fuzzy LIKE，性能较差',
-          fix: '使用 likeRight 或避免左模糊查询'
-        };
-      }
-      return null;
-    }
-  },
-  'NEVER-006': {
-    level: 'P2',
-    name: 'Magic values',
-    pattern: /==\s*[0-9]+\s*\)|==\s*"[^"]+"\s*\)/,
-    check: (content) => {
-      const magicValue = content.match(/(?:status|type|state|level)\s*==\s*(?:[0-9]+|"[^"]+")\s*\)/);
-      if (magicValue) {
-        const lineNum = getLineNumber(content, magicValue[0]);
-        return {
-          line: lineNum,
-          message: '使用 magic values 状态比较',
-          code: magicValue[0],
-          fix: '使用 @EnumValue + CodeMessageEnumable'
-        };
-      }
-      return null;
-    }
-  },
-  
-  // 安全检查
-  'SEC-001': {
-    level: 'P0',
-    name: '硬编码密码',
-    pattern: /password\s*=\s*"[^"]+"/,
-    check: (content) => {
-      const hardcoded = content.match(/(?:password|passwd|pwd|secret|token|key)\s*=\s*"[^"]{8,}"/);
-      if (hardcoded && !hardcoded[0].includes('${') && !hardcoded[0].includes('placeholder')) {
-        const lineNum = getLineNumber(content, hardcoded[0]);
-        return {
-          line: lineNum,
-          message: '硬编码敏感信息',
-          fix: '使用配置文件或环境变量'
-        };
-      }
-      return null;
-    }
-  },
-  'SEC-002': {
-    level: 'P0',
-    name: 'SQL 注入',
-    pattern: /\$\{[^}]+\}/,
-    check: (content) => {
-      // 检查 Mapper XML 中的 ${} 参数
-      if (content.includes('${') && !content.includes('${orderBy')) {
-        const sqlInjection = content.match(/\$\{[^}]+\}/);
-        if (sqlInjection) {
-          const lineNum = getLineNumber(content, sqlInjection[0]);
-          return {
-            line: lineNum,
-            message: 'SQL 注入风险：使用 ${} 参数',
-            fix: '使用 #{} 参数替代'
-          };
-        }
-      }
-      return null;
-    }
-  }
-};
-
-// 获取行号
-function getLineNumber(content, searchStr) {
-  const lines = content.split('\n');
-  for (let i = 0; i < lines.length; i++) {
-    if (lines[i].includes(searchStr.substring(0, 50))) {
-      return i + 1;
-    }
-  }
-  return 1;
-}
-
-// 检查单个文件
-function checkFile(filePath) {
-  const issues = [];
-  
-  if (!existsSync(filePath)) {
-    return issues;
-  }
-  
-  const content = readFileSync(filePath, 'utf-8');
-  
-  for (const [ruleId, rule] of Object.entries(RULES)) {
-    // Quick 模式只检查 P0 规则
-    if (options.quick && rule.level !== 'P0') {
-      continue;
-    }
-    
-    try {
-      const result = rule.check(content, filePath);
-      if (result) {
-        issues.push({
-          ruleId,
-          ruleName: rule.name,
-          level: rule.level,
-          file: filePath,
-          line: result.line || 1,
-          message: result.message,
-          code: result.code || '',
-          fix: result.fix || ''
-        });
-      }
-    } catch (e) {
-      // 规则检查失败，跳过
-    }
-  }
-  
-  return issues;
-}
-
-// 主函数
-function lint() {
-  const results = {
-    p0Count: 0,
-    p1Count: 0,
-    p2Count: 0,
-    p3Count: 0,
-    issues: [],
-    filesChecked: options.files.length,
-    timestamp: new Date().toISOString()
-  };
-  
-  for (const filePath of options.files) {
-    const fileIssues = checkFile(filePath);
-    results.issues.push(...fileIssues);
-    
-    for (const issue of fileIssues) {
-      if (issue.level === 'P0') results.p0Count++;
-      else if (issue.level === 'P1') results.p1Count++;
-      else if (issue.level === 'P2') results.p2Count++;
-      else results.p3Count++;
-    }
-  }
-  
-  return results;
-}
-
-// 输出结果
-function output(results) {
-  if (options.json) {
-    console.log(JSON.stringify(results, null, 2));
-  } else {
-    console.log('\n=== Code Review Lint ===\n');
-    console.log(`检查文件数: ${results.filesChecked}`);
-    console.log(`P0 问题: ${results.p0Count}`);
-    console.log(`P1 问题: ${results.p1Count}`);
-    console.log(`P2 问题: ${results.p2Count}`);
-    console.log(`P3 问题: ${results.p3Count}`);
-    
-    if (results.issues.length > 0) {
-      console.log('\n--- 问题列表 ---\n');
-      
-      const p0Issues = results.issues.filter(i => i.level === 'P0');
-      const p1Issues = results.issues.filter(i => i.level === 'P1');
-      const p2Issues = results.issues.filter(i => i.level === 'P2');
-      
-      if (p0Issues.length > 0) {
-        console.log('### P0 问题（阻断性 - 必须修复）\n');
-        for (const issue of p0Issues) {
-          console.log(`[${issue.ruleId}] ${issue.file}:${issue.line}`);
-          console.log(`  问题: ${issue.message}`);
-          console.log(`  修复: ${issue.fix}\n`);
-        }
-      }
-      
-      if (p1Issues.length > 0) {
-        console.log('### P1 问题（严重 - 必须修复）\n');
-        for (const issue of p1Issues) {
-          console.log(`[${issue.ruleId}] ${issue.file}:${issue.line}`);
-          console.log(`  问题: ${issue.message}`);
-          console.log(`  修复: ${issue.fix}\n`);
-        }
-      }
-      
-      if (p2Issues.length > 0 && !options.quick) {
-        console.log('### P2 问题（最佳实践 - 建议修复）\n');
-        for (const issue of p2Issues) {
-          console.log(`[${issue.ruleId}] ${issue.file}:${issue.line}`);
-          console.log(`  问题: ${issue.message}`);
-          console.log(`  修复: ${issue.fix}\n`);
-        }
-      }
-    }
-    
-    console.log('--- 结论 ---');
-    if (results.p0Count + results.p1Count === 0) {
-      console.log('✅ 通过');
-    } else {
-      console.log(`⚠️ 需修复 ${results.p0Count + results.p1Count} 个 P0/P1 问题后重新评审`);
-    }
-  }
-}
-
-// 执行
-if (options.files.length === 0) {
-  console.error('用法: node lint-code-review.mjs --files <file-list> [--json] [--quick]');
-  process.exit(1);
-}
-
-const results = lint();
-output(results);
-
-// CI 退出码
-if (results.p0Count + results.p1Count > 0) {
-  process.exit(1);
-} else {
-  process.exit(0);
-}

package/skills/domain-modeling/SKILL.md

@@ -1,81 +0,0 @@
----
-name: domain-modeling
-description: 当领域模型不清晰时，从代码或业务语言中提炼领域边界和核心概念
-lifecycle_stage: design
-rule_profile: modeling
-dependencies: []
-triggers:
-  - domain
-  - boundary
-  - reverse engineering
-  - ubiquitous language
-  - module split
-  - model
-inputs:
-  - existing business language
-  - product context
-  - code or documents
-outputs:
-  - domain map
-  - core concepts
-  - boundary notes
-workflow:
-  - extract the core domain terms
-  - group concepts by boundary
-  - identify aggregates and dependencies
-  - hand off to technical-design or spec-refinement
-gates:
-  - stop at domain boundaries
-  - do not implement code
-  - do not write PRD text
-refs:
-  - skills/references/skill-reference-matrix.md
-  - skills/references/rule-loading-map.md
-  - skills/references/prompt-replay-checklist.md
-  - skills/references/full-chain-replay-scenarios.md
----
-
-# Domain Modeling
-
-## Purpose
-
-Extract domain boundaries and core concepts from messy input.
-
-## Suitable / Unsuitable
-
-- Suitable: domain split, reverse engineering, ubiquitous language, boundary discovery
-- Unsuitable: implementation, PRD drafting, detailed test authoring
-
-## Workflow
-
-1. Extract the core domain terms.
-2. Group concepts by boundary.
-3. Identify aggregates and dependencies.
-4. Hand off to `technical-design` or `spec-refinement`.
-
-## Replay Signals
-
-- Input signal: existing business language, product context, code, or documents.
-- Output to verify: domain map, core concepts, boundary notes.
-- Stop signal: implementation code or PRD drafting.
-- Handoff signal: the boundary map is ready for `technical-design` or `spec-refinement`.
-
-## Examples
-
-- Input: "Reverse engineer the customer order domain from this codebase and docs."
-- Output: domain map, core concepts, boundary notes
-- Stop: do not write implementation code or PRD text
-
-## Stop Rules
-
-- Stop at domain boundaries.
-- Do not implement code.
-- Do not write PRD text.
-
-## References
-
-- `skills/references/skill-reference-matrix.md`
-- `skills/references/rule-loading-map.md`
-- `skills/references/prompt-replay-checklist.md`
-- `skills/references/full-chain-replay-scenarios.md`
-

package/skills/domain-modeling/references/README.md

@@ -1,134 +0,0 @@
-# 蒸馏产物使用说明
-
-> 如何将 `distilled/` 目录产物用于 AI 应用开发
-
----
-
-## 作为 AI 应用开发者，如何把产物用起来
-
-### 1. 常驻上下文（语义层）
-
-把语义层注入系统提示或检索的高优先级片段：
-
-```
-- 00-overview.md — 系统全景与给 AI 的约定
-- 01-glossary.md — 业务术语
-- domain/_index.md — 对象关系总览
-- api/_index.md — API 能力清单与典型编排
-```
-
-**加载策略**：
-- 作为 System Prompt 的一部分
-- 或作为 RAG 检索的高优先级片段（权重 > 0.8）
-
-### 2. 按需检索（明细层）
-
-把明细层做成可被 AI 检索的知识库：
-
-```
-- api/<域>/<用例>.md — 各业务用例接口详情
-- reference/schema/*.md — 字段级 Schema
-- reference/enums.md — 枚举/字典值
-- reference/error-codes.md — 错误码
-- reference/model-code-conflicts.md — 模型与代码差异
-```
-
-**检索策略**：
-- 使用向量数据库（如 Milvus、Pinecone）
-- 按 `[[slug]]` 交叉引用定位
-- AI 需要时再取，不常驻上下文
-
-### 3. 接口对接
-
-按 `api/` 文档把真实 API 注册为 AI 可调用的工具：
-
-```json
-{
-  "tools": [
-    {
-      "name": "create_contract",
-      "description": "录入销售合同",
-      "parameters": {
-        "type": "object",
-        "properties": {
-          "contractNo": { "type": "string", "description": "合同编号" },
-          "contractName": { "type": "string", "description": "合同名称" },
-          ...
-        }
-      }
-    }
-  ]
-}
-```
-
-### 4. 运行时护栏
-
-把 `00-overview.md` 的"给 AI 的关键约定"写进系统提示：
-
-```
-## 给 AI 的关键约定
-1. 永远通过 API 操作，不直接读写数据库。
-2. 引用类字段是 ID 不是名称——先调主数据接口解析。
-3. 金额/状态等由服务端计算或裁决。
-4. 写操作权限分级：前期只读，写需确认。
-5. 规则标注 【服务端强制】/【调用方需预判】 的含义。
-```
-
----
-
-## 写权限控制的落地建议
-
-### 前期阶段
-
-- 只把**查询类**接口注册为 AI 工具
-- 写接口不注册或需人工确认
-
-### 进阶阶段
-
-加一层**调用网关**：
-
-```
-GET/查询类 → 直接放行
-写操作 → dry-run 校验 → 回显 → 用户确认 → 提交
-```
-
-### 不可逆操作
-
-- 如确认收款无撤销
-- 必须强制二次确认
-
----
-
-## 典型对话流程
-
-```
-用户: "给华东能源录个合同，软件平台产品，销售一部张敏负责，48 万"
-
-AI:
-1. 解析名称 → 调用 reference-data 接口获取 ID
-2. 回显解析结果给用户确认
-3. 用户确认后调用 create-contract 接口
-4. 返回创建结果
-```
-
----
-
-## 错误处理
-
-当接口返回错误时，AI 根据 `error-codes.md` 解释：
-
-```
-错误: "付款比例合计必须等于 1"
-AI 解释: "您输入的付款比例合计不等于 100%，请调整各阶段比例"
-```
-
----
-
-## 质量验证
-
-定期执行实跑验证：
-
-1. 准备测试集（读/写/统计/规则反例）
-2. 让 AI 仅凭蒸馏文档推导调用
-3. 真打到接口验证结果
-4. 修复发现的文档缺口