diff --git a/实践积累/AI工程/Harness Engineering.md b/实践积累/AI工程/Harness Engineering.md deleted file mode 100755 index 941d03e..0000000 --- a/实践积累/AI工程/Harness Engineering.md +++ /dev/null @@ -1,72 +0,0 @@ -# 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 deleted file mode 100755 index c34c9e0..0000000 --- a/实践积累/AI工程/Superpowers技能框架.md +++ /dev/null @@ -1,87 +0,0 @@ -# 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 deleted file mode 100755 index 1da950b..0000000 --- a/实践积累/AI工程/code-reviewer技能.md +++ /dev/null @@ -1,463 +0,0 @@ ---- -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);
-