chore(marketplace): add karpathy-guidelines-plugin, update dev-coding/dev-review/review-checklist
Karpathy 四原则融合到 req 技能工作流 (REQ-20260421-0003): - dev-coding: 新增 Step 0「验证优先」(Goal-Driven Execution) - dev-review: 五视角 → 六视角,新增 Scope 审计者 (Simplicity + Surgical) - review-checklist/general: 新增 Karpathy 反模式速查表 - karpathy-guidelines-plugin: 新增独立插件,含四原则全文 + 与 req 工作流映射
This commit is contained in:
@@ -73,6 +73,72 @@ ai-proj task append-doc --id <taskId> --content "实现说明"
|
||||
|
||||
---
|
||||
|
||||
## Step 0:验证优先(Karpathy: Goal-Driven Execution)
|
||||
|
||||
**编写任何代码前,必须先写验证脚本。** 规则来源:Karpathy "Goal-Driven Execution" 原则。
|
||||
|
||||
> "Define success criteria. Loop until verified."
|
||||
> "Fix the bug" → "Write a test that reproduces it, then make it pass"
|
||||
|
||||
### 执行流程
|
||||
|
||||
```
|
||||
① 写验证脚本(按类型选择)
|
||||
② 运行一遍,确认全部 FAIL(证明功能确实不存在 / bug 确实存在)
|
||||
③ 编码实现
|
||||
④ 再次运行验证脚本,全部 PASS → 完成
|
||||
```
|
||||
|
||||
### 后端验证脚本模板
|
||||
|
||||
实现 API 前,先写好所有 curl 命令并标注期望结果:
|
||||
|
||||
```bash
|
||||
# 验证脚本:REQ-XXXX [功能名]
|
||||
BASE="http://localhost:8080"
|
||||
TOKEN="<JWT>"
|
||||
|
||||
echo "=== T1: 正常创建 ==="
|
||||
curl -s -X POST "$BASE/api/v1/xxx" \
|
||||
-H "Authorization: Bearer $TOKEN" \
|
||||
-d '{"name":"test"}' | jq '.code'
|
||||
# 期望: 0
|
||||
|
||||
echo "=== T2: 缺少必填字段 ==="
|
||||
curl -s -X POST "$BASE/api/v1/xxx" \
|
||||
-H "Authorization: Bearer $TOKEN" \
|
||||
-d '{}' | jq '.code'
|
||||
# 期望: 非 0(参数错误)
|
||||
|
||||
echo "=== T3: 跨租户访问 ==="
|
||||
curl -s -X GET "$BASE/api/v1/xxx/999" \
|
||||
-H "Authorization: Bearer $TOKEN_OTHER_TENANT" | jq '.code'
|
||||
# 期望: 403
|
||||
```
|
||||
|
||||
**先运行 → 全部 FAIL → 编码 → 再次运行 → 全部 PASS**
|
||||
|
||||
### 前端验证脚本模板
|
||||
|
||||
实现页面前,先列出所有 `data-testid` 和期望的 DOM 状态:
|
||||
|
||||
```
|
||||
验证清单(编码前先确认这些状态不存在 / 行为不正确):
|
||||
- data-testid="xxx-btn-submit" 点击 → 列表刷新,行数增加 1
|
||||
- data-testid="xxx-table" 行数 === API 返回 total
|
||||
- data-testid="xxx-input-name" 空值提交 → 显示「请输入名称」提示
|
||||
```
|
||||
|
||||
### 与 VP 三件套的关系
|
||||
|
||||
| VP 协议 | 验证优先对应 |
|
||||
|---------|------------|
|
||||
| VP-Data | 先在环境建好测试数据(curl 确认成功) |
|
||||
| VP-Steps | **即为本节验证脚本** — 编码前写好,编码后执行 |
|
||||
| VP-Pass | 验证脚本每条命令的期望输出值 |
|
||||
|
||||
---
|
||||
|
||||
## Go 后端开发
|
||||
|
||||
### 分层架构
|
||||
|
||||
Reference in New Issue
Block a user