skill-improver

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

Retrospect and improve Skills/Workflows based on real execution artifacts, making the skill chain more stable with use.

基于真实执行产物回顾并优化Skills/Workflows，让技能链在使用过程中更稳定。

run_dir

runs/<workflow>/active/<run_id>/

(or

openspec/changes/<change-id>/

)

run_dir

：

runs/<workflow>/active/<run_id>/

（或

openspec/changes/<change-id>/

）

```
improvements.md
```
: Improvement suggestions (can be directly converted to change tasks)
Optional: Minimal patch to relevant
```
SKILL.md
```
(only change what's necessary)

Read
```
logs/state.json
```
and
```
logs/events.jsonl
```
, extract:
- Failure points (error types, frequency, missing context)
- Time bottlenecks (repetitive steps, ineffective searches, excessive context)
- Manual confirmation points (whether too early/too late/missing)
Check artifact contracts:
- Whether each step has persisted output
- Whether only paths are passed instead of content
- Whether there are inconsistent naming/paths
Output improvement suggestions (sorted by benefit):
- Prompt/trigger word optimization
- I/O contract completion (add required fields, fix artifact file names)
- Error handling and rejection strategies
- Suggest new deterministic scripts (only when necessary)

读取
```
logs/state.json
```
和
```
logs/events.jsonl
```
，提取：
- 失败点（错误类型、出现频率、缺失的上下文）
- 时间瓶颈（重复步骤、低效搜索、过多上下文）
- 人工确认点（是否过早/过晚/缺失）
检查产物契约：
- 每个步骤是否都持久化了输出
- 是否仅传递路径而非内容
- 是否存在命名/路径不一致的情况
输出优化建议（按收益排序）：
- 提示词/触发词优化
- I/O契约完善（添加必填字段、修正产物文件名）
- 错误处理与拒绝策略
- 建议新增确定性脚本（仅在必要时）