What makes dev-expert notable?

1.9K downloads. Trust evidence available

How should dev-expert be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

dev-expert

编程专家综合技能套件，含17个子技能：软件项目总控、网站项目总控、API设计、Bug诊断、代码生成、代码审查、重构建议、测试用例生成、技术选型、文档生成、任务拆解与执行、Spec驱动开发、Karpathy编码规范、项目记忆管理、CMS二次开发、前端设计、MySQL数据库。按用户输入关键词路由到对应子技能模板执行。关键词路由：软件项目总控(软件项目/API服务/后端服务/后台模块/CLI工具/数据脚本/自动化任务/插件项目/完整功能/项目交付/部署/发布/上线/回滚/运维/监控/告警/巡检)；网站项目总控(做网站/建站/企业官网/营销页/CMS网站/网站上线/网站交付)；API设计(RESTful/GraphQL/接口规范/AJAX防卡死/Init-Step-Poll/长任务接口/轮询接口)；Bug诊断(debug/异常堆栈/报错)；代码生成(写代码/实现功能)；代码审查(code review/安全漏洞/代码缺陷)；重构建议(重构/坏味道/代码异味/可维护性)；测试用例生成(单元测试/集成测试/安全测试/性能测试/长任务测试)；技术选型(技术栈/框架选型)；文档生成(API文档/README/技术文档/部署说明/回滚说明/运维文档)；任务拆解与执行(任务分解/Wave执行)；Spec驱动开发(spec/需求对齐/需求规格)；Karpathy编码规范(Karpathy/编码哲学/简洁优先)；项目记忆管理(项目记忆/跨会话/上下文沉淀)；CMS二次开发(CMS/帝国CMS/WordPress/ThinkPHP/PHP8兼容/二次开发/插件开发/模板开发/批量任务/导入导出/生成静态页)；前端设计(UI设计/UX/交互设计/响应式/设计系统/可访问性/页面视觉/浏览器验证/品牌设计/Banner/图标/社媒图/进度条/轮询状态)；MySQL数据库(MySQL/数据库设计/SQL/索引/事务/慢查询/EXPLAIN/DDL/迁移/表结构/SQL优化)。

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.9k

Updated

Oct 9, 2026

Version

0.1.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.9K downloads reported by the source. Last updated 10/9/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 9, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 9, 2026
Adoption signal: 1.9K downloadsadoption · observed Oct 9, 2026
Latest release: 0.1.0release · observed Aug 15, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17en637qww2q9z3kz1ep6w79988dec4:dev-expert

Install using `clawhub skill install s17en637qww2q9z3kz1ep6w79988dec4:dev-expert` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/ebandao777-oss/dev-expert before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-ebandao777-oss-dev-expert/snapshot"

Documentation

CLAWHUB

76,940 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: dev-expert
description: |
  编程专家综合技能套件，含17个子技能：软件项目总控、网站项目总控、API设计、Bug诊断、代码生成、代码审查、重构建议、测试用例生成、技术选型、文档生成、任务拆解与执行、Spec驱动开发、Karpathy编码规范、项目记忆管理、CMS二次开发、前端设计、MySQL数据库。按用户输入关键词路由到对应子技能模板执行。
  关键词路由：软件项目总控(软件项目/API服务/后端服务/后台模块/CLI工具/数据脚本/自动化任务/插件项目/完整功能/项目交付/部署/发布/上线/回滚/运维/监控/告警/巡检)；网站项目总控(做网站/建站/企业官网/营销页/CMS网站/网站上线/网站交付)；API设计(RESTful/GraphQL/接口规范/AJAX防卡死/Init-Step-Poll/长任务接口/轮询接口)；Bug诊断(debug/异常堆栈/报错)；代码生成(写代码/实现功能)；代码审查(code review/安全漏洞/代码缺陷)；重构建议(重构/坏味道/代码异味/可维护性)；测试用例生成(单元测试/集成测试/安全测试/性能测试/长任务测试)；技术选型(技术栈/框架选型)；文档生成(API文档/README/技术文档/部署说明/回滚说明/运维文档)；任务拆解与执行(任务分解/Wave执行)；Spec驱动开发(spec/需求对齐/需求规格)；Karpathy编码规范(Karpathy/编码哲学/简洁优先)；项目记忆管理(项目记忆/跨会话/上下文沉淀)；CMS二次开发(CMS/帝国CMS/WordPress/ThinkPHP/PHP8兼容/二次开发/插件开发/模板开发/批量任务/导入导出/生成静态页)；前端设计(UI设计/UX/交互设计/响应式/设计系统/可访问性/页面视觉/浏览器验证/品牌设计/Banner/图标/社媒图/进度条/轮询状态)；MySQL数据库(MySQL/数据库设计/SQL/索引/事务/慢查询/EXPLAIN/DDL/迁移/表结构/SQL优化)。
version: "1.5.1"
author: "智慧半岛"
---

# dev-expert -- 编程专家综合技能

本技能是一个综合技能套件，包含多个子技能。接到用户请求后，按以下流程执行。

## 执行流程

### Step 1: 意图识别与路由匹配

分析用户输入，与下方路由表逐一比对。匹配规则：

- 用户输入中包含路由表中「子技能」列的关键词 → 匹配该子技能
- 用户输入中包含路由表中「功能说明」列中提到的场景 → 匹配该子技能
- 多个子技能同时匹配时，先按「子技能优先级矩阵」组合路由；无法组合时再选择匹配度最高的
- 无法唯一确定时，向用户确认意图

### Step 2: 加载子技能模板

匹配到子技能后，根据子技能索引表找到对应的文件路径，**必须**使用 `Read` 工具读取 `references/` 目录下的完整执行模板。

### Step 3: 按模板执行

严格按照加载的模板逐步执行。模板中定义了：

- 输入要求（用户需要提供什么）
- 执行步骤（每一步做什么、如何判断）
- 输出格式（最终产出的结构和规范）
- 质量标准（产出必须满足的底线）

### Step 4: 输出结果

按模板规定的格式输出结果。如果模板要求生成文件，写入后声明产出物。

## 约束规则

1. **必须先读模板再执行**：匹配到子技能后，严禁凭记忆或猜测执行，必须先读取对应的 references 文件
2. **严格遵循模板**：不得跳过步骤、不得省略检查项、不得自行简化流程
3. **输入不足时主动索取**：模板中标注「必填」的输入项缺失时，向用户索取
4. **质量底线不妥协**：模板中的质量标准必须逐条满足

## 本包特色

- **软件项目总控**：面向 API 服务、后台模块、插件、CLI 工具、数据脚本和自动化任务等非网站项目，先定义项目边界、行为契约、架构、数据/API/集成、发布回滚、监控告警、巡检运维和交付沉淀，再进入 Wave 执行
- **网站项目总控**：面向做网站/建站/CMS网站/企业官网/营销页等完整项目，先定义项目启动、站点规划、内容SEO、前端设计、CMS/API/数据、任务Wave、测试安全、性能部署、验收交接和运维沉淀，再调用任务拆解与执行落地
- **CMS二次开发**：PHP+MySQL CMS 二次开发子技能提供 CMS 自动探测、PHP 版本选型矩阵、数据库操作规范、PHP 8.x 兼容性检查、安全红线、插件开发标准，与代码生成/Bug诊断/代码审查/技术选型深度联动
- **前端设计**：融合 UI/UX Pro Max 规则，覆盖设计思维、信息架构、视觉 token、字体配对、品牌规范、Banner、图标、社媒图、组件状态、响应式、可访问性、CMS模板页面和浏览器验证
- **MySQL数据库**：独立覆盖表结构设计、SQL安全、索引、事务、慢查询、迁移回滚和 PHP/CMS 数据访问约束
- **AJAX 渐进式防卡死**：长任务强制采用 Init → Step → Poll 架构，覆盖 CMS 批处理、导入导出、静态生成、采集同步、前端进度轮询和 API 契约

- **Karpathy编码哲学**：所有代码产出遵循'先思考、简洁优先、避免浪费、手工胜于模板'原则，代码生成前必须先完成逻辑推演
- **Wave执行模式**：任务拆解与执行子技能按依赖分Wave串行执行，每Wave完成后验证再进入下一Wave，上下文隔离避免污染
- **Spec驱动开发**：Spec驱动开发子技能在编码前强制对齐需求规格，用artifact flow分离提案/实施/验证三阶段

## 路由表

| 子技能           | 功能说明                                                                                                       |
| ---------------- | -------------------------------------------------------------------------------------------------------------- |
| 软件项目总控     | 通用软件项目从需求到交付的总控：边界、行为契约、架构、数据/API/集成、测试、安全、发布、回滚和沉淀。            |
| 网站项目总控     | 从需求到上线的建站项目总控：站点规划、内容SEO、前端设计、CMS/API/数据、测试安全、性能部署、验收运维。          |
| API设计          | 根据业务需求设计RESTful或GraphQL API接口...                                                                    |
| Bug诊断          |

README.md

# 编程专家 - dev-expert

面向软件工程师和开发团队的编程全生命周期助手。覆盖从软件项目总控、网站项目总控、需求分析、前端设计、MySQL数据库、代码生成、Bug诊断到重构、测试、文档、上线交付和运维监控的全链路，通过17个子技能提供专业化支持。特别强化PHP+MySQL CMS二次开发场景，提供CMS自动探测、PHP版本选型、数据库规范、安全红线、AJAX渐进式防卡死等专项指引。

## 子技能列表

| 子技能 | 功能 | 触发关键词 |
|--------|------|-----------|
| 软件项目总控 | 通用软件项目从需求到交付的总控：边界、行为契约、架构、数据/API/集成、测试、安全、发布、回滚、监控、告警、巡检和沉淀 | 软件项目, API服务, 后端服务, 后台模块, CLI工具, 数据脚本, 自动化任务, 插件项目, 完整功能, 项目交付, 部署, 发布, 回滚, 运维, 监控, 告警, 巡检 |
| 网站项目总控 | 从需求到上线的建站项目总控：站点规划、内容SEO、前端设计、CMS/API/数据、测试安全、性能部署、验收运维 | 做网站, 建站, 企业官网, 营销页, CMS网站, 网站上线, 网站交付 |
| API设计 | 根据业务需求设计RESTful或GraphQL API接口，长任务采用 Init-Step-Poll 契约 | API设计, RESTful, GraphQL, 接口规范, AJAX防卡死, Init-Step-Poll, 长任务接口, 轮询接口 |
| Bug诊断 | 分析错误日志和异常堆栈，定位Bug根因并给出修复方案 | Bug诊断, debug, 报错, 异常堆栈 |
| Karpathy编码规范 | 提供Karpathy核心编码哲学：思考优先、简洁至上 | Karpathy编码规范, Karpathy, 编码哲学 |
| Spec驱动开发 | 编码前对齐需求规格，使用OpenSpec artifact flow | Spec驱动开发, spec, 需求对齐 |
| 代码审查 | 审查代码质量，发现Bug、安全漏洞和代码缺陷 | 代码审查, code review, 代码缺陷 |
| 代码生成 | 根据功能需求生成高质量代码，含错误处理和边界条件 | 代码生成, 生成代码, 实现功能 |
| 任务拆解与执行 | 将复杂需求拆分为原子任务，按Wave分组执行 | 任务拆解与执行, 任务分解, Wave执行 |
| 技术选型 | 根据项目需求推荐合适技术栈、框架和工具 | 技术选型, 技术栈, 框架选型 |
| 文档生成 | 根据代码生成技术文档、README、API文档、部署说明和运维文档 | 文档生成, API文档, README, 部署说明, 回滚说明, 运维文档 |
| 测试用例生成 | 生成单元测试、集成测试、安全测试、性能测试和长任务测试 | 测试用例生成, 单元测试, 测试用例, 安全测试, 性能测试, 长任务测试 |
| 重构建议 | 分析代码结构，识别坏味道并提供重构方案 | 重构建议, 重构, 坏味道, 代码异味 |
| 项目记忆管理 | 捕获上下文和决策，实现跨会话项目记忆沉淀 | 项目记忆管理, 项目记忆, 跨会话 |
| CMS二次开发 | PHP+MySQL CMS 二次开发全链路：CMS探测/PHP版本/数据库规范/安全红线/插件开发/长任务防卡死 | CMS, 帝国CMS, WordPress, ThinkPHP, PHP8兼容, 二次开发, 插件开发, 批量任务, 导入导出, 生成静态页 |
| 前端设计 | UI/UX 与前端实现设计：设计思维、信息架构、视觉规范、品牌、Banner、图标、社媒图、响应式、可访问性、浏览器验证、进度轮询 | 前端设计, UI设计, UX, 交互设计, 响应式, 设计系统, 品牌设计, Banner, 图标, 社媒图, 进度条, 轮询状态 |
| MySQL数据库 | MySQL 数据建模、SQL安全、索引设计、事务边界、慢查询诊断、迁移回滚和数据安全 | MySQL, 数据库设计, SQL, 索引, 事务, 慢查询, EXPLAIN, DDL, 迁移, 表结构, SQL优化 |

## 使用方法

通过 Marvis 对话自然触发，说出需求即可自动匹配对应子技能。

## 协同技能

### 子技能内部协同
17个子技能通过"关联Skill"章节相互引用，形成全生命周期闭环。常见协同路径：
- 通用软件项目：软件项目总控 → Spec驱动开发 → 技术选型/API设计/MySQL数据库/CMS二次开发 → 任务拆解与执行 → 代码生成 → 代码审查 → 测试用例生成 → 文档生成/部署运维说明 → 项目记忆管理
- 网站项目：网站项目总控 → Spec驱动开发 → 任务拆解与执行 → 前端设计/CMS二次开发/API设计/MySQL数据库 → 代码生成 → 代码审查 → 测试用例生成 → 文档生成 → 项目记忆管理
- 需求阶段：Spec驱动开发 → 任务拆解与执行 → 前端设计/代码生成
- 页面阶段：前端设计 → 代码生成 → 代码审查 → 测试用例生成 → 文档生成
- 交付阶段：代码生成 → 代码审查 → 测试用例生成 → 文档生成/部署运维说明
- 治理阶段：Bug诊断/重构建议 → 代码审查 → Karpathy编码规范 → 项目记忆管理
- CMS二开：CMS二次开发 → (前端设计/代码生成/Bug诊断/代码审查/技术选型) → 项目记忆管理
- MySQL专项：MySQL数据库 → 代码生成/代码审查/Bug诊断 → 测试用例生成 → 项目记忆管理
- AJAX防卡死：Init → Step → Poll，API设计 → 前端设计 → CMS二次开发/代码生成 → 测试用例生成
- 沉淀阶段：任何子技能 → 项目记忆管理（记录决策/规范/summary）

### 跨技能包协同
本技能包为独立套件，暂无可直接联动的其他职业技能包。如需在编程任务中集成外部数据或服务，可使用主Agent的web_search/web_fetch工具获取。

## 版本

v1.5.1 | 更新日期: 2026-07-02

## 变更日志

### v1.5.1 (2026-07-02)

- 任务拆解模板新增安全触发面识别，Wave 任务必须写明安全验证项
- SKILL.md 新增部署、发布、回滚、运维、监控、告警、巡检路由
- 软件项目总控补强监控指标、告警阈值、巡检清单和运维交付材料
- 测试用例生成补齐安全测试、性能测试和 Init-Step-Poll 长任务测试分类

### v1.5.0 (2026-07-02)

- 新增 软件项目总控 子技能（references/software-project.md）
- 覆盖 API 服务、后台模块、插件、CLI 工具、数据脚本、自动化任务等非网站项目的完整交付链
- 修正组合路由规则：多子技能命中时先按优先级矩阵组合路由，无法组合时才选最高匹配度
- 补强任务拆解关联链和项目记忆流程格

_meta.json

{
  "ownerId": "kn7096hdmqr56bh0825xpz8ft188dh24",
  "slug": "dev-expert",
  "version": "0.1.0",
  "publishedAt": 1786814953369
}

references/api-design.md

# API设计 -- 智能API设计

## 输入要求

1. **业务需求**（必填）：需要设计的业务场景和功能
2. **数据模型**（必填）：核心实体和字段
3. **接口类型**（可选）：RESTful或GraphQL，默认RESTful
4. **已有接口**（可选）：如果已有部分接口需要兼容
5. **特殊要求**（可选）：如"需要支持批量操作"、"需要Webhook回调"

## 执行流程

### 第一步：Spec场景检查

设计前检查是否有明确的spec：

- **如有spec**：提取spec中的Requirement和Scenario作为接口设计依据，确保每个Requirement对应至少一个端点，每个Scenario映射为接口的成功/错误响应
- **如无spec**：提示用户先使用 `Spec驱动开发` 对齐需求，或基于业务需求生成轻量级spec

```
✓ Spec场景检查: [检测到/未检测到] 需求规格
[如检测到，列出 Requirement → 端点 映射]
```

### 第二步：需求分析

- 识别API的使用场景和用户
- 确定API的功能边界
- 明确输入输出数据模型

### 第三步：设计原则应用

- 应用RESTful或GraphQL设计原则
- 设计URL结构和HTTP方法
- 定义请求/响应格式

### 第四步：详细设计

- 设计每个端点的详细规范
- 定义错误处理策略
- 设计认证和授权机制
- 如接口涉及长任务/批处理/导入导出/生成任务，必须采用 `Init → Step → Poll` AJAX 渐进式防卡死架构

### 第五步：API规范定义

```markdown
## API Spec: [API名称]

### ADDED Requirements

#### Requirement: [端点名称]

The system SHALL provide an endpoint to [功能描述].

##### Scenario: 成功请求

- GIVEN [前置条件]
- WHEN 发送 `[METHOD] [路径]` 请求
- THEN 返回 [状态码] 和 [响应体]

##### Scenario: 错误处理

- GIVEN [错误前置条件]
- WHEN 发送 `[METHOD] [路径]` 请求
- THEN 返回 [错误状态码] 和 [错误响应体]

### Design

- **URL结构**: [结构说明]
- **认证方式**: [认证机制]
- **版本策略**: [版本管理]

### File Changes

- `[API定义文件]` (new/modified)

```

### 第六步：文档生成

- 生成OpenAPI/Swagger规范
- 编写使用示例
- 提供SDK代码示例

### 第七步：记录到项目记忆

API 设计完成后，将关键决策和规范记录到项目记忆（参见 `project-memory-management.md`）：
- 记录 API 设计决策（如 RESTful vs GraphQL 选择理由）
- 记录接口命名约定和版本策略
- 记录认证/授权方案的选型依据

## 输出格式

````

## API设计文档

### 资源定义

| 资源     | 说明   | 核心字段   |
| -------- | ------ | ---------- |
| [资源名] | [说明] | [字段列表] |

### 接口列表

#### [接口名称]

**URL**：`[METHOD] /path`
**说明**：[功能说明]

**请求参数**：
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| [字段] | [类型] | [是/否] | [说明] |

**响应格式**：

```json
{
  "code": 0,
  "data": { ... },
  "message": "success"
}
```

**错误码**：
| 错误码 | 说明 |
|--------|------|
| [CODE] | [说明] |

### 通用规范

- **认证方式**：[Bearer Token / API Key / OAuth2]
- **版本控制**：[URL路径 / Header / 参数]
- **分页方式**：[页码分页 / 游标分页]
- **数据格式**：[snake_case / camelCase]

### 长任务接口规范（如适用）

| 端点 | 方法 | 说明 |
|------|------|------|
| `/tasks/{type}/init` | POST | 创建任务，返回 `task_id`、`total`、初始状态 |
| `/tasks/{task_id}/step` | POST | 执行一批处理，返回进度和 `has_more` |
| `/tasks/{task_id}/poll` | GET | 查询任务状态、进度、错误和结果 |

**Step 响应必须包含**：`task_id`, `status`, `processed`, `total`, `percent`, `has_more`, `message`, `errors`

````

## 质量标准

- URL必须使用名词复数形式，不能用动词（如/users而非/getUsers）
- HTTP方法必须符合语义（GET无副作用、POST创建、PUT幂等更新、DELETE删除）
- 错误响应必须包含机器可读的错误码和人工可读的消息
- 分页接口必须说明最大页大小和默认页大小
- 敏感操作（删除、批量修改）必须要求二次确认或特殊权限
- 不得设计返回超大列表的接口（必须分页或流式）
- 长任务/批处理接口必须采用 `Init → Step → Poll`，不得设计为单请求同步阻塞执行
- Step 接口必须幂等、可重试，并限制单批处理数量

## 失败回退机制

| 步骤 | 失败条件 | 回退目标 | 最大重试 | 不可恢复时升级路径 |
|------|---------|---------|---------|------------------|
| 第一步：Spec场景检查 | 无spec且业务需求模糊 | 基于业务需求生成轻量级spec草案 | 1 | 标注"需求未对齐"，建议先走 Spec驱动开发 |
| 第二步：需求分析 | 业务场景涉及多个领域，边界不清 | 拆分为多个子API分别设计 | 2 | 输出需求拆分建议，由用户确认后继续 |
| 第三步：设计原则应用 | RESTful与GraphQL均不完全契合 | 选择主风格+局部例外，标注例外原因 | 1 | 输出两套方案对比，由用户决策 |
| 第四步：详细设计 | 认证/授权机制与现有系统冲突 | 降级到最简认证（Bearer Token），标注待对齐 | 2 | 输出认证方案选型矩阵，

references/bug-diagnosis.md

# Bug诊断 -- 智能Bug诊断

## 输入要求

1. **错误信息**（必填）：错误日志、异常堆栈或报错截图
2. **相关代码**（必填）：出错的代码片段
3. **运行环境**（可选）：操作系统、语言版本、依赖版本
4. **复现步骤**（可选）：如何触发这个错误

## 执行流程

### 第一步：Spec场景检查

诊断前先检查相关spec中的scenario：
- **如有spec**：确认bug是否涉及spec中的scenario，检查scenario的Given/When/Then是否被正确实现
- **spec与实现不一致**：可能是spec理解偏差导致的bug
- **无spec**：诊断后建议补充spec防止同类bug

```
✓ Spec场景检查:
- 相关Scenario: [scenario名称]
- 预期行为: [spec定义]
- 实际行为: [观察到的行为]
- 偏差分析: [spec vs 实现]
```

### 第二步：已知问题检查

检查项目记忆中的已知问题：
- 搜索项目记忆中的类似bug记录
- 检查是否有已知的workaround
- **发现新问题**：诊断完成后提示记录到项目记忆

### 第三步：错误解析

- 识别错误类型（语法错误、运行时错误、逻辑错误、环境错误）
- 提取关键信息（错误码、错误消息、发生位置）
- 分析堆栈跟踪（调用链、最后执行位置）

### 第四步：根因分析

| 错误类型 | 常见根因 | 分析方法 |
|---------|---------|---------|
| **语法错误** | 拼写错误、括号不匹配、缩进错误 | 定位到具体行号和字符 |
| **运行时错误** | 空指针、数组越界、类型错误 | 检查变量状态和数据流 |
| **逻辑错误** | 条件判断错误、算法缺陷 | 追踪执行路径和中间结果 |
| **环境错误** | 依赖缺失、版本不兼容、配置错误 | 检查环境和依赖信息 |
| **并发错误** | 竞态条件、死锁、资源竞争 | 分析线程/协程交互 |

### 第五步：定位问题

- 指出具体的代码位置（文件、函数、行号）
- 说明变量在错误时刻的状态
- 追踪数据流找到问题源头

### 第六步：提供修复（Surgical Changes）

- 给出修复后的代码
- 说明修复原理
- **Karpathy约束**：只修改修复Bug必需的代码，不改相邻代码、风格、注释
- 提供验证修复的方法

### 第七步：定义成功标准（Goal-Driven Execution）

基于已确定的根因和修复方案，明确定义"修复成功"的标准：
- **复现测试**：写一段能稳定触发Bug的测试/步骤
- **成功标准**：修复后应达到什么状态（如"空邮箱不再导致崩溃"）
- **验证方法**：如何确认修复有效（如"运行复现测试10次均通过"）

**示例**：
```
成功标准：用户邮箱为空字符串时，validate_user() 抛出 ValueError 而非崩溃。
复现测试：调用 validate_user({'email': ''}) → 应抛出 ValueError。
验证方法：运行复现测试 → 通过。
```

### 第八步：记录到项目记忆

修复完成后，将关键决策和变更记录到项目记忆（参见 `project-memory-management.md`）：
- 记录 Bug 根因和修复方案（Decision Record 模式）
- 记录新增的预防措施和编码规范（Convention Capture 模式）
- 更新已知问题清单，防止同类 Bug 复发

## 输出格式

```
## Bug诊断报告

**错误类型**：[语法/运行时/逻辑/环境/并发]
**错误信息**：[核心错误消息]
**发生位置**：[文件/函数/行号]

## 根因分析

**问题描述**：[一句话说明]
**详细分析**：[逐步推理过程]
**相关代码**：
```[问题代码]```

## 修复方案

```[修复后的代码]```

**修复说明**：[为什么这样修复]

## 验证方法

1. [步骤1]
2. [步骤2]

## 预防措施

- [建议1]
- [建议2]
```

## 质量标准

- 根因分析必须基于代码和日志证据，不能猜测
- 修复代码必须可运行，且能解决原问题
- 必须提供验证方法，让用户确认修复有效
- 对于不确定的根因，标注"最可能的原因"并列出其他可能性
- 环境相关错误必须说明具体的环境要求或版本限制
- 不得建议用户"重启试试"或"重新安装"作为首要方案
- **Karpathy红线**：修复前必须先写复现测试，修复后验证测试通过
- **Karpathy红线**：只修改修复Bug必需的代码，不改相邻代码、风格、注释

## CMS 常见 Bug 模式

当诊断对象为 PHP+MySQL CMS 时，优先排查以下模式：

| Bug 类型 | 典型表现 | 常见根因 | 修复方向 |
|----------|---------|---------|---------|
| PHP 版本兼容 | `Fatal error: Uncaught TypeError` / `Deprecated:` | 低版本代码运行在高版本 PHP | 参见 `cms-development.md` PHP 8.x 兼容性检查表 |
| CMS 缓存失效 | 修改代码后页面无变化 | CMS 模板/数据缓存未清理 | 清理 `runtime/` `e/tmp/` `data/dbcache/` 后重试 |
| 模板引擎错误 | 标签不解析或输出原始标签 | 模板语法错误或引擎版本差异 | 检查模板标签闭合和 CMS 版本对应语法 |
| 数据库表前缀 | `Table 'xxx_tablename' doesn't exist` | 表前缀配置与实际不一致 | 检查 CMS 配置文件中的表前缀设置 |
| MySQL 慢查询 | 页面卡顿 / SQL 超时 / CPU 飙高 | 缺索引、全表扫描、排序临时表 | 采集 SQL、参数、表行数和 EXPLAIN，参考 `mysql-database.md` |
| MySQL 死锁 | `Deadlock found when trying to get lock` | 事务顺序不一致或锁范围过大 | 缩短事务、统一更新顺序、检查索引命中 |
| 序列化数据 | `unserialize(): Error at offset` | WordPress `wp_options` 等序列化数据损坏 | 用 `maybe_unserialize()` 或修复序列化字符串长度 |
| 伪静态路由 | 404 或路由不生效 | `.htaccess` / Nginx rewrite 规则缺失 | 检查伪静态规则和 CMS 路由配置 |
| 文件编码 | 中文乱码 / `headers already sent` | UTF-8 BOM

Github ReposUpdated 9h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.