| | 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 导致的同节重复,大重构时整文件重写