laohu-evolution · diff
git:20260926.bc495aa to git:20260927.984f11d
53 added, 65 removed. Audit A to A.
---
name: laohu-evolution
- description: 当已选方法要落实为长期能力时，保留原则、条件、步骤与可变形式的关系，接通实际执行并用下游产物检查；不重判未决专业方法或代改当前作品。
+ description: 当用户已选定长期能力改进方法并要求写回时，重构实际规则与调用链、保留有效行为并核对交付；不重判未定的专业取舍或代改当前作品。
---
- 开始本入口前，解析当前 `SKILL.md` 所在真实目录为 `{SKILL_DIR}`，读取 `{SKILL_DIR}/../../../docs/runtime.md`；本轮已加载则复用。该文件提供跨项目的路径、授权、交接和保存约定，读完回到本入口执行。
+ 开始本入口前，解析当前 `SKILL.md` 所在真实目录为 `{SKILL_DIR}`，读取 `{SKILL_DIR}/../../../docs/runtime.md`；本轮已加载则复用。令 `{PROJECT_ROOT}` 为解析 `{SKILL_DIR}/../../..` 后的项目根目录，并核验该结构确为目标仓库且包含 `AGENTS.md` 与 `tools/check_project.py`。维护老胡仓库时，读取 `{PROJECT_ROOT}/AGENTS.md`，并按本轮变更读取 `{PROJECT_ROOT}/docs/maintenance.md`；再按目标和文件动作读取本入口 References。
# 老胡能力进化
- `{SKILL_DIR}` 是本文件所在目录的真实路径（解析符号链接）；`{PROJECT_ROOT}` 是解析 `{SKILL_DIR}/../../..` 后的项目根目录。执行命令前核实根目录实际包含 `AGENTS.md` 和 `tools/check_project.py`，并替换占位符。
+ **已确认的方法写进实际运行链，改进才会留在下一次任务里。**
- ## 职责
+ ## 核心职责与边界
- 把已确认的能力改进落实到实际执行会读取或运行的位置，使预期判断和下游产物真正改变，同时保留有效旧行为及适用条件。实施者负责规则表述、文件组织、依赖接入、必要示范和实现修正；不能把这些工作推回 analysis。任务内可以生成明确标为待验的试作；不得把 AI 自拟的作品、文案或反馈写入正式 Skill／Reference 充当教学范例。长期范例按 [规则表达与方法保留](references/rule-expression.md) 的来源门处理。
+ **专业取舍由已确认方案决定，文件与调用由本入口接通。**
- 专业方法、核心范围和关键取舍以用户已选定的具体方案或 `laohu-analysis` 已确认的结论为依据。当前作品及其图片、视频、封面和提示词成品交给对应专业入口。专业四层的定义由 `{SKILL_DIR}/../laohu-analysis/references/capability-design.md` 唯一维护；本入口检查其关系能否在规则和实际产物中继续发挥作用，不另造定义。
+ 把已确认的能力目标、专业方法和关键取舍写进未来执行者会实际加载或运行的位置，让普通请求能沿最终文件完成工作。实施者负责核对现状、判断真正控制行为的文件、保留或整理原有内容、改写运行方法、接通消费者、同步适用的界面与评测，并完成授权范围内的结构及实现检查。
- 本主文负责落实已确认的整体目标、范围、授权、跨入口职责和全局停止/返回条件；专业 Reference 可以在这一范围内给出并执行领域判据、方法分支和操作判断。Reference 不能借专业细节改变上游确认的目标或权限、接管其他入口职责，或把未定的核心取舍写成既定结论。若新材料使这些整体决定需要重选，按下文把受影响部分交回 analysis；其余可恢复实施继续。
+ 本入口实施长期能力，不替用户重新裁决未定的专业方法、范围或关键取舍；这些判断会改变规则时，带着缺项和影响交回 analysis。文件位置、段落组织、自然措辞、引用接入及其他可恢复实现由本入口负责，不把普通编辑推回 analysis。当前作品、封面、图片、视频与提示词成品由适用专业能力完成；文件关联不自动产生跨入口授权。
- 目标领域 Skill 的主文还须保留该能力统领专业工作的核心判断、主要步骤及其衔接；Reference 深入专项方法、复杂判据或独立子流程。不能把主文空化为路径路由，也不能让 Reference 退化为脱离执行的知识摘录。主文与 Reference 共同形成专业执行链，但各自范围保持清楚。
+ 已定方法或经用户明确选定的政策可以实施。分别标明已选定的规则和已验证的效果；不因尚无本地数据而阻止经授权的可恢复试用，也不把试用预期写成结果。外部报告、理论名称或他人意见不代替已确认依据；用户明确要求跳过分析并亲自选定规则时按其决定执行，同时保留它尚未被外部依据验证的身份。
- 只有会改变专业方法、核心范围、授权或关键取舍的缺项才返回 analysis；退回时指出缺项、影响和依赖它的写入，保留其他已完成工作。常规措辞、结构、格式和可恢复实现由本入口决定并继续。
+ 目标领域 Skill 的主文必须保留统领专业工作的判断、完整主要步骤和步骤衔接；Reference 深入可独立调用的专业方法或分支，不能成为只供引用的知识摘录，也不能改写上游目标、权限、入口职责或全局返回条件。
- ## 执行
+ ## 选择局部修改还是整体重构
- ### Step 1：接收并校准依据
+ **改动范围跟着真实缺口走。**
- 用户明确要求维护未来可复用的能力时继续；一次性作品修改交给对应专业入口。
+ 按已授权范围判断改动大小，不按文件数量或文字长度判断：
- 1. 用户已选定的具体方案或 analysis 已选定的实施路径可以执行；备选与待决内容不冒充定案。
- 2. 有依据且已获授权的候选方法可以制作可恢复版本并试用。分别说明“已选定实施”和“效果已验证”；不能因本项目效果尚未证明而阻止试用。
- 3. 核对方案中的对象和适用条件是否仍对应目标文件与当前运行路径。这是范围核对，不是重查根因。
+ - 用户给出确定文字、路径、已知修法或单点接口修复，且其他职责与依赖不需调整：完成对应局部修改。
+ - 用户要求新建或整体重构能力，或核心职责、主要方法、Reference 分工与消费者彼此牵连：按完整设计实施，保证从目标、架构、分项方法到最终交付接成一体。
+ - 修改过程中发现必须重选的目标、权限、核心方法或关键取舍：只暂停依赖该项的写入，将具体材料、影响和待决问题交 analysis；其余已授权且不依赖该项的内容继续。
- **analysis 交接完整性：** 要解决问题时，只核对方案能否实施，不重设计专业方案，也不要求 analysis 先写完每个字符。检查以下内容是否明确：
+ 一次小改动不自动启动全面设计；一项完整能力也不能靠给旧段落加标题冒充重构。范围大时先确认它确实响应用户已选的方案，再按后文全流程落实。
- - 真实控制位置与要增、改、删的内容；
- - 含条件和要求强度的核心规则、专业选择、关键分支与目标效果；
- - 保护项、实施顺序或依赖、可观察的验收方式。
+ ## 进入实施并核对现状
- 若缺项会改变目标、授权、专业方法或关键验收，列出缺项及影响，暂停依赖该项的写入并返回 analysis。其他措辞、结构、示范、接入和可恢复实现继续由本入口完成。不得用“优化一下规则”代替方案，也不把待决事项当成已确认。
+ **先认清当前文件实际控制什么，再动手。**
- **外部建议与用户授权：**
+ 沿用已有任务状态和用户的授权，不重复询问已确定事项。先确认目标项目和真实 Skill 目录，读取目标主文、本轮会影响行为的 Reference、实际调用方、配置、脚本和相关评测。结合失败产物或反馈记录，找出执行者真正读取或运行的控制点；文件存在、链接可点或规则文字完整，都不证明下游已调用它。
- - 外部报告、其他 Skill 的建议或用户对原因的解释将决定规则内容、方法、范围或例外，而这些实质判断仍未定：建议先交 analysis 核对，暂停依赖它的部分。
- - 用户已授权调用 analysis：读取 `{SKILL_DIR}/../laohu-analysis/SKILL.md`，交接具体待判项；不得声称尚未发生的调用。
- - 用户明确要求跳过 analysis，并亲自选定具体规则：按授权实施；注明这是用户选择，不代表外部依据已经核实。
- - 已确定的路径、文案、格式及不依赖待决实质判断的技术操作：照常完成；不把附带原因猜测写成事实。
+ 编辑前保留目标目录当前实际内容及可恢复路径，尤其保护未提交、未跟踪和被忽略材料，不能只把 Git HEAD 当作备份。建立简短工作映射：本轮目标、现有控制位置、保留内容、要改或合并的内容、依赖和预期观察。不要另造只供归档的报告。
- ### Step 2：核对现状与控制位置
+ 整体重构或跨文件迁移时，将原有判断单元映射到目标位置和实际消费者，并按已确认方案落实保留、替换、增补、合并、分支或删除。专业内容的取舍依据由 analysis 或用户已选方案确定；本入口不机械保留全部旧文，也不自行删除、改弱或重判实质方法。对移动、删除和多文件依赖，按 [能力文件增、改、删](references/change-workflow.md) 搜索现有消费者并安排先后；写入方法与表达时按 [规则表达与方法保留](references/rule-expression.md) 保住已选判断的条件、作用和承载形式。取舍尚未确定且会改变运行时，带着具体差异返回 analysis，不让两个相冲突的指令并存。
- 已有 Skill 的升级或经验注入，按本轮目标项目读取：
+ ## 逐部分写回已确认方法
- 1. 先明确目标项目，读取该项目适用的 `AGENTS.md`（存在时）及目标 Skill 的 `SKILL.md`；不把能力安装仓库自动当成修改对象。
- 2. 读取目标 Skill 本轮需要的直接引用、脚本、模板和评测。
- 3. 读取产生反馈的作品、失败输出或变更记录。
- 4. 只有迁移成熟机制时，才读外部项目对应真源和验证记录。
+ **每个步骤都要有输入、决定、动作和去处。**
- 随后检查目标文件、已确认条件和当前消费者，找出实际控制预期行为的入口、规则、脚本、配置及必要调用方。用简短工作映射对齐目标与依据、预期变化、要保护的旧行为和真实控制点；无需另建映射报告。不能只改解释文字而漏掉实际入口或运行文件。
+ 有完整设计依据时，依其整体结构逐部分落实：每个环节说明输入、决定条件、动作、中间产物、下一位消费者、分支和停止点；再把它们接成目标领域主 Skill 的专业主线。只修改说明而不改实际调用者，或把需要生成的专业产物留给未来执行者猜，都不算完成。无需用形式相同的标题复制设计顺序；根据该能力真正的分工组织主文与 Reference。
- 无论 analysis 交接是否逐项列出，都要核对目标 Skill 所承接的输入、对象、产物、排除任务，以及越界响应、交接和停止条件。只在已确认职责内补成可执行规则；若缺项意味着核心范围、目标、专业方法或授权须改变，返回 analysis，不自行扩张。若目标正式产物属于另一入口，按 `{PROJECT_ROOT}/docs/runtime.md` 判断跨入口授权和负责人，不因目标文件相邻、共用负责人或只读所需 Reference／归档辅助而推断已有正式制作或写回授权。
+ 将已确认的作品用途与读者要求写进实际的生成步骤和成品验收：按真实使用情境，落实接收者需要理解、感受或采取的行动，再选择相应体裁、语言、组织和版式。不同产物按实际需要确定形式，不预设封闭类别或统一报告模板；源头规则的表达方式不会自动成为目标作品的语体。最终产物服务人的阅读或使用，需要机器读取的部分继续遵守精确接口，不用解释文字破坏契约。
- 若发现目标冲突、授权变化，或缺少会改变核心规则／专业方法的判断，暂停依赖该问题的写入；不受影响的工作继续。将材料路径、影响、需要 analysis 决定的问题、可继续部分及返回后的接续步骤交回 analysis。不要自行补理论或扩大成全面审查。
+ 写入或迁移运行规则时读取 [规则表达与方法保留](references/rule-expression.md)，处理方法、出处、语言力度、正例和 Markdown 组织；完成后返回本节实施。它是原则句、机制解释、执行办法、结果纠偏与文档形式的唯一细则来源。专业四层的定义只由 analysis 的 capability-design 维护，evolution 负责将已选关系接入规则和实际产物，不复制第二套定义。
- ### Step 3：按条件读取实施 Reference
+ 创作与审美规则采用用户指定的“现代汉语的诗学箴言体”：原则句凝练、有方向、有分量；机制解释材料关系与边界，执行步骤把取舍落到动作，成品验收负责纠偏。四者相互承接，不是每段要填齐的栏目；原话完整保留在 Reference。普通操作、事实、权限、文件路径与停止条件用准确直白的现代汉语。章节帮助扫读，段落只讲清一项中心，真正关键的判断加粗，表格只呈现真实对照；不设字数限制，也不把每节硬凑成格言。
- - **文件动作、范围、界面配置、多个消费者或调用链：** 读取 [能力文件增、改、删](references/change-workflow.md)，定位真源、执行者和依赖，完成适用的界面及多文件要求，再回到 Step 4。
- - **新增或改写运行规则、迁移已确认方法或较长流程、制作可复用成品示例：** 读取 [规则表达与方法保留](references/rule-expression.md)，按其语义选择 Markdown 形式、方法保真与示范要求写回，再回到 Step 4。
- - **普通单文件路径、措辞或配置修正：** 无需读取方法 Reference；按已确认方案实施。
+ 把已选方法写进实际运行规则时，优先保留用户给出的准确适用原句、标准术语和核心命题，并让它们承担真实判断；写在目标 Skill 主文或实际读取的 Reference 里，不只存进背景资料。原句或术语已能指导本地选择时直接使用；只有迁移后仍有歧义或执行缺口，才补足必要的本地条件、动作或取舍，并标清来源原意与适配。外部引文先核对原文与上下文，按版权作必要短引并注明出处；无法核验时明确转述，不冒充原话。保留原方法的优先级、步骤、条件、舍弃对象和力度。直接复用不等于免于理解、来源核验或适用性判断；正式创作范例不得由 AI 自编或伪造，来源暂缺时标出缺口并继续落实可执行方法，临时试作与长期范例分开。
- 未来执行者必须能凭正常任务输入和随能力交付且会实际加载的文件完成工作。本次已确认的聊天方案要编入运行文件，不让未来任务依赖制作聊天。Reference 应写明专项方法的判断依据、适用条件、动作和局部失败处理；它可以在授权范围内作专业判断，但不得推翻已确认的总体目的、权限、入口职责及全局暂停/返回路由。若依赖 Reference 的专项判断会改动核心方法或范围，先把具体缺项交回 analysis。
+ 研究和建设阶段可以访问外部来源核实材料；写入运行 Reference 时，把已选方法、适用条件、步骤、判断、例外和必要的短引或本地用法写在本地，不保留外部 URL/网页链接，也不要求执行者点开来源来补足方法。作者、书名、版本、章节、页码等书目信息，以及原文、译文和本地适配的区别，仍按规则表达 Reference 保留。来源无法核实时，收窄主张并标待核，继续落实已有依据的部分。这条不禁止任务本身需要的时效事实核查、新作品核验或用户指定研究；是否查证由该任务的目的和授权决定，不由 Reference 为缺失的方法内容派发网页访问。
- 如需接入分层知识或选项资源，按本步骤第一项所列 [能力文件增、改、删](references/change-workflow.md) 完成触发条件、实际读取范围、顺序和返回位置；由 analysis 已定的任务依赖指导接入，不在主文重复一套固定加载数量或目录结构。
+ ## 整合主 Skill 与整体执行链
- ### Step 4：实施并接通行为链
+ **各部分写得正确，还要能合起来完成同一个任务。**
- 把每项已定要求落到实际规则、消费者和检查；先前条件、强度、例外与示范作用不能被最近摘要覆盖。规则表达 Reference 负责详细保真方法，`capability-design.md` 负责专业四层定义；本步骤负责接入实际消费者，让输入、执行者、必要动作、适用分支、可检查产物和失败返回形成完整链路。修改所有实际控制预期行为的文件与调用方。
+ 完整重构不是逐份 Reference 各自改好就结束。把已确认的目标、专业判断和主要步骤重新写入目标 Skill 主文，让普通请求能沿一条完整路径走到目标产物；把分散在多处的同一判断合并到唯一真源，再让各章节和 Reference 按条件接续。
- 专业关系、适用条件或核心取舍未确定时，带具体缺项返回 analysis；措辞、章节组织、引用接入及其他可恢复实现由本入口完成。本步骤不重判已确认的专业方法，也不弱化用户确认的表达风格。
+ 用至少一项普通任务做方案走查，从入口推演到应有的完整局部产物：检查每一步的决定是否发生在需要它的位置，中间结果是否被下一步实际使用，条件变化是否进入正确分支，整体交付是否保留目标、偏好、事实与权限边界，并适合真实读者的理解、感受或使用。文档读起来完整不证明作品适配；按授权用真实任务输入生成代表产物，检查体裁与形式是否服务其用途，必要的机器接口是否完整。只有用户已授权的任务内试作才实际制作局部产物；走查不要求正式作品制作。对局部修复，只检查受影响的路径及必要近邻，不强制重建整条能力。
- ### Step 5：按变更类型验证
+ 如果章节顺序、触发条件或 Reference 调用需要改变才能让全流程成立，就直接重排主文和调用关系；不要把旧段落原样铺开，只为它们添加更多标题。完整流程仍应允许局部请求跳过无关步骤，只有真实依赖决定先后。
- 先选择与本次变更相符的检查：
+ ## 接通文件、界面和评测
- | 变更 | 必查内容 |
- |---|---|
- | 路径、格式或文件动作 | 真实目标、引用、调用链与保护项 |
- | 路由变更 | 正确请求、近邻反例及项目实际发现 |
- | 方法迁移 | 代表性输入到实际产物、关键分支、例外、失败路径和应保留的旧行为 |
- | 脚本变更 | 实际运行成功与失败路径 |
- | 规则表达变更 | 关键对象、必要解释、术语作用、重复真源及正反例 |
+ **规则真源唯一，消费者逐个接好。**
- 方法、表达或交接规则改动后，在选试跑样本前读取 `{SKILL_DIR}/../laohu-analysis/references/validation.md`，按其区分示例复现、旧行为回归和留出验证。由未参与候选设计的执行者使用正常任务输入，实际加载最终交付的 Skill 与所需 References，确认产物能从这些文件独立产生。需要检查迁移时，另选未参与候选设计、对象与关键条件不同的留出样本；旧版和新版都通过只证明原行为保持，不证明能力改善。不提供制作聊天有助于避免提示，但本身不构成留出验证。
+ 多文件修改是一组变更：先明确唯一真源，再按“运行规则 → 直接依赖与调用方 → 界面配置 → 代表评测”同步。改主文时确认它在何时加载哪些确切 Reference、Reference 解决什么判断、读后回到何处；同步现有消费者，不重复维护整套规则。新建文件须有独立职责和真实调用者。用户要求能力范围变化或整体重构时，同步核对 agents/openai.yaml 的展示名称、说明与默认提示词，并维护能代表该变化的 evals/evals.json 案例；不得删除或弱化已有案例来隐藏失败。
- **创作方法专用检查：** 只有本次确实迁移或改进一项具备明确原理、作品关系和可变实现的创作方法时，才检查同一原理在不同材料下能否产生有效的不同形式、条件失效时能否退出或换法、示范是否被误读为固定配方。普通路径、标点或不涉及创作方法的格式修改不承担这组检查。
+ 创作或表达规则写作需要保留专业例作时，按来源门处理；要给实现者的产品规则、机器字段或固定输出模板时，保留精确接口。不得把资料、样例、内部审核过程或猜测写进最终成品，除非用户明确要求该内容作为交付。
- 创建或实质改进能力时，用普通需求建立或改进目标能力，并使用最终文件产生下游完整局部产物；不以文件完成替代用户结果。分别记录目标效果与保护项：代表样本显示目标未实现时记 `FAIL`，不能用真实用户质量未知改报 `UNKNOWN`。局部指标全通过而整体效果失败时，检查评价是否漏掉关系或相互作用。只有缺少真实接收者或实际使用质量证据时，质量才记 `UNKNOWN`。
+ ## 按证据验收并交付
- 比较旧版时从改前实际快照读取，不能把变动中的当前文件称为旧版；使用实际执行证据报告结构、行为和质量状态。Checker 通过不证明行为或质量提升。按结果处理：
+ **检查通过到哪一级，就只报告到哪一级。**
- | 发现 | 后续动作 |
- |---|---|
- | 样本显示实现偏离已确认方案 | 修正实现并重跑对应检查。 |
- | 方法已完整执行，代表产物仍未达到目标 | 返回 Step 2，将具体失败证据交给 analysis 重查方法与适用条件。 |
- | 输入、环境或评价无效 | 先修复对应部分，再重跑受影响检查；不把这些失败一概归咎于规则。 |
- | 关键检查失败或未完成 | 不报告完成。 |
+ 按变更类型分别检查真实路径、引用、格式、调用和受保护内容。维护老胡仓库时，交付前从已核实的根目录运行 python3 tools/check_project.py；脚本、发现或版本逻辑变化时，另按 maintenance 要求运行离线回归。不要准备版本、提交、推送或发布，除非另有明确授权。
- **仓库维护要求：** 维护老胡仓库时，实施前读取 `{PROJECT_ROOT}/docs/maintenance.md` 的本地检查要求，交付前从已核验的仓库根目录运行适用检查；准备版本时再读其版本与发布部分。修改其他项目时，读取并执行目标项目的维护与验证要求，不用老胡仓库检查代替目标验收。维护命令只在 `docs/maintenance.md` 维护。
+ 验证 analysis 或 evolution 等元入口时，分两段检查：先用最终 analysis/evolution 从普通需求实际建立或整体改进一个目标能力；再由另一位未参与目标能力设计、未见该新样本设计过程的执行者，仅凭最终能力文件和新的普通输入，独立完成下游任务并交付完整产物。只看方案、文件结构、同一设计样本或修改者自评，都不能证明元入口已把能力建设交给未来使用。
- ## 完成交付
+ 对非元入口目标能力的方法或行为作实质改进时，需要由未参与候选设计的执行者仅凭最终主文、实际会读取的 Reference 和普通任务输入，独立生成下游产物。检查条件变化会不会改变选择，下一步是否真正使用前一步产物，保护项是否保留。静态检查最多证明结构；走查最多证明方案可接手；一次试跑不自动证明稳定性或真实质量。按项目定义报告 STRUCTURE、ROUTE、BEHAVIOR、QUALITY 状态；未执行的行为写明未验证，真实接收者或使用结果缺失时质量为 UNKNOWN，代表产物已经显示目标未达到时为 FAIL。
- 在聊天说明实际改动路径、接入位置、验证结果和仍未知之处。只把有长期回归或维护价值的方法、输入和观察保存在既有职责位置，并保留适用条件；替代旧做法时合并或移除失效补丁。默认不创建每次执行的结果 JSON、哈希报告、审计日志或空目录。
+ 交付时说明实际修改路径、各文件承担的职责、保留/重写/合并/迁移/删除的范围、检查结果、未验证项和可恢复位置。行为验证由独立执行者报告时，区分其观察与结构检查，不将未完成的结果写成通过。
+
+ ## Reference 索引
+
+ **按改动读取方法，读完回到对应步骤。**
+
+ - [能力文件增、改、删](references/change-workflow.md)：涉及文件动作、多个消费者、调用链、目录或界面与评测同步时读取；完成依赖映射后回到“接通文件、界面和评测”。
+ - [规则表达与方法保留](references/rule-expression.md)：写入、改写或迁移运行方法、创作原则、来源和示范时读取；完成规则保真与文档组织后回到“逐部分写回已确认方法”。
+ - [分析的完整能力设计](../laohu-analysis/references/capability-design.md)：实施整体重构且交接方案依赖完整架构时读取，核对设计链覆盖；它不代替本入口检查现状与写回。
+ - [分析的必要试验与方案走查](../laohu-analysis/references/validation.md)：改动方法、行为或交接设计时读取，按变更选择适用检查；读完返回本节验证，不把走查当成实际运行。