mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-04-10 11:23:32 +08:00
docs(zh-CN): update
This commit is contained in:
@@ -1,10 +1,10 @@
|
||||
---
|
||||
description: 从会话中提取可重用模式,在保存前自我评估质量,并确定正确的保存位置(全局与项目)。
|
||||
description: "从会话中提取可重用模式,在保存前自我评估质量,并确定正确的保存位置(全局与项目)。"
|
||||
---
|
||||
|
||||
# /learn-eval - 提取、评估、然后保存
|
||||
|
||||
扩展 `/learn`,在写入任何技能文件之前加入质量门和保存位置决策。
|
||||
扩展 `/learn`,在编写任何技能文件之前,加入质量门控、保存位置决策和知识放置意识。
|
||||
|
||||
## 提取内容
|
||||
|
||||
@@ -52,41 +52,66 @@ origin: auto-extracted
|
||||
[触发条件]
|
||||
```
|
||||
|
||||
5. **在保存前自我评估**,使用此评分标准:
|
||||
5. **质量门控 — 清单 + 整体裁决**
|
||||
|
||||
| 维度 | 1 | 3 | 5 |
|
||||
|-----------|---|---|---|
|
||||
| 具体性 | 仅抽象原则,无代码示例 | 有代表性代码示例 | 包含所有使用模式的丰富示例 |
|
||||
| 可操作性 | 不清楚要做什么 | 主要步骤可理解 | 立即可操作,涵盖边界情况 |
|
||||
| 范围契合度 | 过于宽泛或过于狭窄 | 基本合适,存在一些边界模糊 | 名称、触发器和内容完美匹配 |
|
||||
| 非冗余性 | 几乎与另一技能相同 | 存在一些重叠但有独特视角 | 完全独特的价值 |
|
||||
| 覆盖率 | 仅涵盖目标任务的一小部分 | 涵盖主要情况,缺少常见变体 | 涵盖主要情况、边界情况和陷阱 |
|
||||
### 5a. 必需清单(通过实际阅读文件进行验证)
|
||||
|
||||
* 为每个维度评分 1–5
|
||||
* 如果任何维度评分为 1–2,改进草案并重新评分,直到所有维度 ≥ 3
|
||||
* 向用户展示评分表和最终草案
|
||||
在评估草案**之前**,执行以下所有操作:
|
||||
|
||||
6. 请求用户确认:
|
||||
* 展示:提议的保存路径 + 评分表 + 最终草案
|
||||
* 在写入前等待明确确认
|
||||
* \[ ] 使用关键字在 `~/.claude/skills/` 和相关项目的 `.claude/skills/` 文件中进行 grep 搜索,检查内容重叠
|
||||
* \[ ] 检查 MEMORY.md(项目级和全局级)以查找重叠内容
|
||||
* \[ ] 考虑是否追加到现有技能即可满足需求
|
||||
* \[ ] 确认这是一个可复用的模式,而非一次性修复
|
||||
|
||||
7. 保存到确定的位置
|
||||
### 5b. 整体裁决
|
||||
|
||||
## 第 5 步的输出格式(评分表)
|
||||
综合清单结果和草案质量,然后选择**以下一项**:
|
||||
|
||||
| 维度 | 评分 | 理由 |
|
||||
|-----------|-------|-----------|
|
||||
| 具体性 | N/5 | ... |
|
||||
| 可操作性 | N/5 | ... |
|
||||
| 范围契合度 | N/5 | ... |
|
||||
| 非冗余性 | N/5 | ... |
|
||||
| 覆盖率 | N/5 | ... |
|
||||
| **总计** | **N/25** | |
|
||||
| 裁决 | 含义 | 下一步行动 |
|
||||
|---------|---------|-------------|
|
||||
| **保存** | 独特、具体、范围明确 | 进行到步骤 6 |
|
||||
| **改进后保存** | 有价值但需要改进 | 列出改进项 → 修订 → 重新评估(一次) |
|
||||
| **吸收到 \[X]** | 应追加到现有技能 | 显示目标技能和添加内容 → 步骤 6 |
|
||||
| **放弃** | 琐碎、冗余或过于抽象 | 解释原因并停止 |
|
||||
|
||||
**指导维度**(用于告知裁决,不进行评分):
|
||||
|
||||
* **具体性和可操作性**:包含可立即使用的代码示例或命令
|
||||
* **范围契合度**:名称、触发条件和内容保持一致,并专注于单一模式
|
||||
* **独特性**:提供现有技能未涵盖的价值(基于清单结果)
|
||||
* **可复用性**:在未来的会话中存在现实的触发场景
|
||||
|
||||
6. **裁决特定的确认流程**
|
||||
|
||||
* **改进后保存**:呈现必需的改进项 + 修订后的草案 + 一次重新评估后的更新清单/裁决;如果修订后的裁决是**保存**,则在用户确认后保存,否则遵循新的裁决
|
||||
* **保存**:呈现保存路径 + 清单结果 + 1行裁决理由 + 完整草案 → 在用户确认后保存
|
||||
* **吸收到 \[X]**:呈现目标路径 + 添加内容(diff格式) + 清单结果 + 裁决理由 → 在用户确认后追加
|
||||
* **放弃**:仅显示清单结果 + 推理(无需确认)
|
||||
|
||||
7. 保存 / 吸收到确定的位置
|
||||
|
||||
## 步骤 5 的输出格式
|
||||
|
||||
```
|
||||
### Checklist
|
||||
- [x] skills/ grep: no overlap (or: overlap found → details)
|
||||
- [x] MEMORY.md: no overlap (or: overlap found → details)
|
||||
- [x] Existing skill append: new file appropriate (or: should append to [X])
|
||||
- [x] Reusability: confirmed (or: one-off → Drop)
|
||||
|
||||
### Verdict: Save / Improve then Save / Absorb into [X] / Drop
|
||||
|
||||
**Rationale:** (1-2 sentences explaining the verdict)
|
||||
```
|
||||
|
||||
## 设计原理
|
||||
|
||||
此版本用基于清单的整体裁决系统取代了之前的 5 维度数字评分标准(具体性、可操作性、范围契合度、非冗余性、覆盖度,评分 1-5)。现代前沿模型(Opus 4.6+)具有强大的情境判断能力 —— 将丰富的定性信号强行压缩为数字评分会丢失细微差别,并可能产生误导性的总分。整体方法让模型自然地权衡所有因素,产生更准确的保存/放弃决策,同时明确的清单确保不会跳过任何关键检查。
|
||||
|
||||
## 注意事项
|
||||
|
||||
* 不要提取琐碎的修复(拼写错误、简单的语法错误)
|
||||
* 不要提取一次性问题(特定的 API 中断等)
|
||||
* 专注于能在未来会话中节省时间的模式
|
||||
* 保持技能聚焦 — 每个技能一个模式
|
||||
* 如果覆盖率评分低,在保存前添加相关变体
|
||||
* 专注于那些将在未来会话中节省时间的模式
|
||||
* 保持技能聚焦 —— 每个技能一个模式
|
||||
* 当裁决为“吸收”时,追加到现有技能,而不是创建新文件
|
||||
|
||||
Reference in New Issue
Block a user