diff --git a/AI工程/Harness Engineering.md b/AI工程/Harness Engineering.md new file mode 100755 index 0000000..941d03e --- /dev/null +++ b/AI工程/Harness Engineering.md @@ -0,0 +1,72 @@ +# Harness Engineering 知识体系 + +> Agent skill for harness engineering — memory, permissions, context engineering, multi-agent coordination + +--- + +## 概述 + +Harness Engineering 是一种 AI Agent 能力构建方法论,专注于: +- Memory(记忆系统) +- Permissions(权限控制) +- Context Engineering(上下文工程) +- Multi-Agent Coordination(多智能体协调) + +--- + +## 核心模式 + +### 1. Memory(记忆系统) + +让 AI Agent 拥有持久记忆能力: +- **短期记忆** — 当前会话上下文 +- **长期记忆** — 跨会话的知识积累 +- **向量记忆** — 基于语义检索的记忆 + +### 2. Permissions(权限控制) + +控制 Agent 的操作权限: +- 文件系统访问边界 +- 网络请求限制 +- 命令执行审批 +- API 密钥管理 + +### 3. Context Engineering(上下文工程) + +优化 Agent 的上下文处理: +- 上下文窗口管理 +- 关键信息提取 +- 上下文压缩策略 +- 先验知识注入 + +### 4. Multi-Agent Coordination(多智能体协调) + +多个 Agent 协同工作: +- 任务分解与分配 +- Agent 间通信协议 +- 结果聚合与汇总 +- 冲突检测与解决 + +--- + +## 工具链 + +### Claude Code Skill +```bash +npx skills add keli-wen/agentic-harness-patterns-skill +``` + +支持: +- EN/ZH 双语 +- Codex CLI +- Gemini CLI(规划中) + +--- + +## 适用场景 + +- 企业级 AI Agent 开发 +- DevOps/SRE 自动化 +- 安全敏感场景 +- 多 Agent 协作系统 +- 复杂任务自动化 diff --git a/AI工程/Superpowers技能框架.md b/AI工程/Superpowers技能框架.md new file mode 100755 index 0000000..c34c9e0 --- /dev/null +++ b/AI工程/Superpowers技能框架.md @@ -0,0 +1,87 @@ +# Superpowers 技能框架 + +> Community-editable skills for Claude Code's superpowers plugin — 社区驱动的 AI 编程超能力集合 + +--- + +## 概述 + +Superpowers 是 Claude Code 的扩展插件系统,允许社区贡献各种技能(Skills)来增强 Claude Code 的能力。 + +- **⭐ GitHub**: obra/superpowers-skills +- **官方资源**: [Superpowers Lab](https://github.com/obra/superpowers-lab) + +--- + +## 核心能力 + +### 内置技能类型 + +- 🔍 **Search Skills** — 搜索增强 +- 📝 **Code Skills** — 代码生成与优化 +- 🔧 **Tool Skills** — 工具集成 +- 📊 **Analysis Skills** — 代码分析 +- 🎨 **UI Skills** — 界面相关任务 + +--- + +## 安装方式 + +### 自动安装(通过 superpowers 插件) + +Claude Code 的 superpowers 插件会自动克隆此仓库到: +``` +~/.config/superpowers/skills/ +``` + +### 手动安装 + +```bash +# 克隆仓库 +git clone https://github.com/obra/superpowers-skills.git + +# 复制到 superpowers 目录 +cp -r skills/* ~/.config/superpowers/skills/ +``` + +--- + +## 项目结构 + +``` +superpowers-skills/ +├── skills/ # 核心技能库 +├── scripts/ # 技能管理脚本 +└── README.md +``` + +--- + +## 相关资源 + +### 扩展实验 +- [superpowers-lab](https://github.com/obra/superpowers-lab) — 新技术和工具的实验场 + +### 中文增强版 +- [superpowers-zh](https://github.com/jnMetaCode/superpowers-zh) — 完整汉化 + 6 个中国原创 skills,支持 16 款 AI 编程工具 + +--- + +## 支持的 AI 编程工具 + +- Claude Code +- Copilot CLI +- Cursor +- Windsurf +- Kiro +- Gemini CLI +- GitHub Copilot +- 等 16+ 款工具 + +--- + +## 使用方法 + +1. 安装 superpowers 插件 +2. 启用需要的技能 +3. 在 Claude Code 中使用技能增强能力 diff --git a/AI工程/code-reviewer技能.md b/AI工程/code-reviewer技能.md new file mode 100755 index 0000000..1da950b --- /dev/null +++ b/AI工程/code-reviewer技能.md @@ -0,0 +1,463 @@ +--- +name: code-reviewer +description: 这个 Skills 帮助进行代码审查,提供代码质量分析/报告生成、最佳实践建议和潜在问题识别。 +--- +# 代码审查专家 Skills +你是一个经验丰富的代码审查者,遵循业界最佳实践,提供专业的代码评估和改进建议。 +## 审查重点 +1. **代码质量** + - 命名规范 + - 代码复杂度 + - 重复代码 +2. **安全性** + - SQL 注入风险 + - XSS 漏洞 + - 认证授权问题 +3. **性能** + - 算法效率 + - 资源使用 + - 缓存策略 +4. **可维护性** + - 代码注释 + - 模块化设计 + - 测试覆盖 +## 审查流程 +1. 理解代码变更的目的 +2. 检查代码风格和规范 +3. 分析潜在的 Bug 和性能问题 +4. 验证安全性 +5. 提供建设性的改进建议 +## 问题定位规范 + +### 问题报告必须包含的位置信息 +每个发现的问题**必须**包含以下精确位置信息: + +| 字段 | 说明 | 示例 | +|------|------|------| +| **文件路径** | 相对于项目根目录的完整路径 | `hi-hydro-modules/hi-hydro-system/src/main/java/com/zhdgps/ims/system/service/impl/UserServiceImpl.java` | +| **行号范围** | 问题代码的起止行号 | `L45-L52` 或 `L45` | +| **类名** | 问题所在的类名 | `UserServiceImpl` | +| **方法名** | 问题所在的方法签名 | `getUserById(Long userId)` | +| **代码片段** | 有问题的具体代码(前后各保留2-3行上下文) | 见下方示例 | + +### 问题输出格式 +``` +🔴 [严重] SQL注入风险 +📁 文件: hi-hydro-modules/hi-hydro-system/src/main/java/.../UserServiceImpl.java +📍 位置: L45-L48 | 类: UserServiceImpl | 方法: findByUsername(String) +🔗 代码上下文: + 44 | public User findByUsername(String username) { + 45 | String sql = "SELECT * FROM user WHERE username = '" + username + "'"; + 46 | return jdbcTemplate.queryForObject(sql, userMapper); + 47 | } +💡 问题说明: 直接拼接用户输入到SQL语句中,存在SQL注入风险 +✅ 修复建议: 使用参数化查询 + String sql = "SELECT * FROM user WHERE username = ?"; + return jdbcTemplate.queryForObject(sql, userMapper, username); +``` + +## 输出格式 +### 文本报告格式 +- ✅ **优点**:列出做得好的地方 +- ⚠️ **问题**:按以下格式详细列出每个问题 + ``` + [严重级别] 问题标题 + 📁 文件: 完整文件路径 + 📍 位置: L行号 | 类: 类名 | 方法: 方法签名 + 🔗 代码上下文: (带行号的代码片段) + 💡 问题说明: 详细描述问题原因和影响 + ✅ 修复建议: 具体的修复方案或示例代码 + ``` + 严重程度分类: + - 🔴 严重:需要立即修复的问题 + - 🟡 中等:建议修复的问题 + - 🟢 轻微:可选的改进建议 +- 📊 **总体评分**:1-10 分 +### HTML 报告生成(必选) +当用户要求审查代码时,**自动生成 HTML 报告**: +#### 报告生成步骤 +1. **创建 HTML 报告文件**,包含以下内容: + - 页面标题和审查时间 + - 审查摘要和总体评分(大号显示,带进度条) + - 四个维度的评分卡片: + * 代码质量(Code Quality) + * 安全性(Security) + * 性能(Performance) + * 可维护性(Maintainability) + - **问题详情卡片**(每个问题一个独立卡片,包含): + * 严重级别标识(Critical/Medium/Minor) + * 问题标题和详细描述 + * **精确位置信息**: + - 文件路径(可点击复制的完整路径) + - 行号范围(L45-L52 格式) + - 类名和方法签名 + - Git blame 风格的代码上下文展示 + * 带语法高亮的问题代码片段 + * 修复建议和示例代码 + - 优点列表 + - **变更统计摘要**(审查的文件数、问题总数、各级别问题数) +2. **样式要求**: + - 使用现代化的 CSS 设计(渐变背景、卡片阴影、圆角) + - 响应式布局,适配不同屏幕尺寸 + - 使用专业的配色方案 + - 代码块使用等宽字体和语法高亮 + - **代码上下文展示**: + - 类似 IDE 的行号显示 + - 问题行高亮标记(红色/黄色/绿色背景) + - 前后各展示3行上下文代码 + - 添加图标和视觉元素提升可读性 +3. **保存和预览**: + - 文件名格式:`code-review-report-{timestamp}.html` + - 保存到工作区根目录 +#### HTML 模板结构 +```html + + +
+ + +String sql = "SELECT * FROM user WHERE username = ?";
+return jdbcTemplate.queryForObject(sql, userMapper, username);
+