# Project Experience Distillation

> Synthos skill: project-experience-distillation

- Skill: `yakeworld/project-experience-distillation` (Agent Skill, multi-file: 12 files)
- Install (CLI): `npx skillmds@latest add yakeworld/project-experience-distillation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yakeworld/project-experience-distillation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: yakeworld (https://skillmd.com/u/yakeworld)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/yakeworld/project-experience-distillation

---



|
| 1 | **抽象不够** — 只在项目级别描述而不提升到通用级别 | 去掉项目名/路径/日期，保留可跨复用的模式 |
| 2 | **只记录不反思** — 记录了步骤没问"为什么有效" | 思想提升是灵魂，不是可选的 |
| 3 | **和 project-absorption 混淆** — 本技能是内部反思，project-absorption 是外部吸收 | 内部反思 = 从自身实践学；外部吸收 = 从外部项目学 |
| 4 | **轻易创建新 skill** | 普遍规律优先扩展现有技能，只有个性化规则才新开 |
| 5 | **建完 skill 不跑质量门** | 新建 skill 至少通过 L1 格式门 |
| 6 | **文档退化** — 累积 patch 操作导致同一节重复出现 | 大重构时重写整个文件，不累积 patch |
| 7 | **抽象级别不够深** — 只去掉实体名没上升到约束类型级别 | 真正的抽象是识别出**约束类型**，不是去掉名字保留模板 |

## IO_CONTRACT

- **input**: `project_practice: md` — 具体项目实践记录（含步骤、项目名、路径、日期）
- **input**: `reflection_q: "为什么有效"` — 反思问题（思想提升，非可选；目标是识别约束类型）
- **output**: `reusable_patterns` — 去掉项目名/路径/日期后上升到约束类型级别的跨项目可复用模式
- **output**: `skill_update: SKILL.md diff` — 优先扩展现有技能；确需新建时至少通过 L1 格式质量门

## 原则 (Principles)

- **追问其效**：只记步骤而不问「为什么有效」，则记录为形，反思方为魂；灵魂不可省。
- **抽象至型**：真抽象是识别**约束类型**，非去实体名而留模板；未升型者，仍为项目级描述。
- **内外有别**：内部反思（从自身实践学，P0）与外部吸收（project-absorption，P1）不可混淆，混淆则源流乱。
- **重则重写**：普遍规律优先扩展现有技能；文档大重构时整文件重写，不累积 patch，免同节重复之退化。


## Genes (策略基因)

> 紧凑策略表示。条件→策略。需要深度时参考完整文档。

- **[PROJ-001]** 记录项目实践时 → 必须追问“为什么有效”以提炼思想灵魂，而非仅记录步骤
- **[PROJ-002]** 进行经验抽象时 → 需识别并上升到“约束类型”级别，而非仅去除实体名保留模板
- **[PROJ-003]** 区分经验来源时 → 严格区分内部反思（自身实践，P0）与外部吸收（外部项目，P1），避免源流混淆
- **[PROJ-004]** 发现普遍规律时 → 优先扩展现有技能，仅在规则高度个性化时才新建 Skill
- **[PROJ-005]** 新建 Skill 后 → 必须至少通过 L1 格式质量门验证，确保基础合规
- **[PROJ-006]** 文档出现累积 Patch 导致重复时 → 执行大重构并整文件重写，禁止继续累积 Patch

## 参考文件

- `ref/project-absorption-pattern.md` — 内部反思 vs 外部吸收对比方法论。两者是双向进化引擎：内部反思从自身实践学（P0），外部吸收从外部项目学（P1）。
- `references/batch-loop-pattern.md` — 批量循环执行模式。

## 示例 · EXAMPLES

**输入**：`project_practice: "P141 视网膜剪切 ODE 调优：从 P140 基线出发，alpha 0.65→0.55，发现正反馈耦合致 A 冲顶，改加性 eps*(A-A_hp) 后 ablation 5.81x"`
**输出**：`reusable_patterns: ["正反馈耦合（乘性）必然导致变量冲顶 → 约束类型: 耦合必须加性且基线锚定", "新域参数搜索从已验证基线出发单参步进，不盲扫多维"]`；扩展 ode-simulation-tuning 技能 Pitfalls 第 15 条

**输入**：`project_practice: "batch_fix_all.py 修复 88 篇论文 DOI 覆盖率 0%→82%"`
**输出**：`reusable_patterns: ["聚类检索（按主题 5 方向 × 1 次）替代逐篇 80 次检索，40min→2.5min"]` → 扩展现有 paper-literature-supplement 技能，不新建 skill

## Golden 集合 · GOLDEN SET

- **Golden Input**: `project_practice: "P141 视网膜剪切 ODE 调优：从 P140 基线出发，alpha 0.65→0.55，发现正反馈耦合致 A 冲顶，改加性 eps*(A-A_hp) 后 ablation 5.81x"`（取自 EXAMPLES 真实项目实践，覆盖正常路径）
- **Golden Output**: `reusable_patterns: ["正反馈耦合（乘性）必然导致变量冲顶 → 约束类型: 耦合必须加性且基线锚定", "新域参数搜索从已验证基线出发单参步进，不盲扫多维"]` — 已去除项目名/路径/日期并上升到约束类型级别（PROJ-002），且 `skill_update` 为扩展 ode-simulation-tuning 的 SKILL.md diff（PROJ-004 优先扩展不新建）
- **Golden Error**: 实践记录未回答反思问题"为什么有效"（PROJ-001），或提炼结果仍含项目实体名/未升型到约束类型（PROJ-002）时 → 拒绝产出 `reusable_patterns`，报"只记录不反思/抽象未升型"并要求补充反思后再提炼---





|
| 1 | **抽象不够** — 只在项目级别描述而不提升到通用级别 | 去掉项目名/路径/日期，保留可跨复用的模式 |
| 2 | **只记录不反思** — 记录了步骤没问"为什么有效" | 思想提升是灵魂，不是可选的 |
| 3 | **和 project-absorption 混淆** — 本技能是内部反思，project-absorption 是外部吸收 | 内部反思 = 从自身实践学；外部吸收 = 从外部项目学 |
| 4 | **轻易创建新 skill** | 普遍规律优先扩展现有技能，只有个性化规则才新开 |
| 5 | **建完 skill 不跑质量门** | 新建 skill 至少通过 L1 格式门 |
| 6 | **文档退化** — 累积 patch 操作导致同一节重复出现 | 大重构时重写整个文件，不累积 patch |
| 7 | **抽象级别不够深** — 只去掉实体名没上升到约束类型级别 | 真正的抽象是识别出**约束类型**，不是去掉名字保留模板 |


- **Golden Error**: 预期错误信息（覆盖失败路径）
## 验证清单 (Verification)
- [ ] 提炼已去掉项目名/路径/日期，上升到可跨项目复用的模式
- [ ] 已问"为什么有效"并提炼出约束类型（而非仅去掉实体名保留模板）
- [ ] 区分内部反思（本技能）与外部吸收（project-absorption），未混淆
- [ ] 普遍规律优先扩展现有技能，未轻易新建 skill
- [ ] 新建 skill 已至少通过 L1 格式质量门
- [ ] 无累积 patch 导致的同节重复，大重构时整文件重写