关于 evolve-skills
这是一项独立技能,用于从对话、技能使用和外部资料中识别有依据的改进或新技能提案。它强调范围界定、证据追溯、历史决策、权衡分析及修改前验证。
主要功能
- 01界定目标与证据范围
- 02追溯对话和技能使用证据
- 03查阅既有演进记录
- 04构思并比较变更假设
- 05规划提案的验证方式
适用场景
- 01根据实际使用评估技能
- 02审查限定范围的对话
- 03回滚已记录的演进
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ sakana-y/ skills --skill evolve-skills安装后在 Claude Code 中输入/evolve-skills确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/evaluation-records.mdexternal-learning.mdhistory.mdretention-and-migration.mdvalidation.mdscripts/evaluation_record.pytests/test_evaluation_record.py详细介绍
演进技能
从对话、技能使用和相关外部想法中学习,以改进未来的使用。具体的对话片段可能揭示从未使用过某项技能的机会,或值得提议为新技能的独特职责。先明确每个目标的用途:机会包括值得保留的成功方法、未达成的结果、不必要的投入,以及更好的工作组织方式。判断机会时,应看它对目标的贡献,而不是看 Agent 是否遵循了每条指令,或技能是否还能增加更多功能。
这是一项显式调用、独立运行的技能。它可以与单独选用的深入探讨方法配合使用,以便更深入地讨论假设和权衡。若这些技能单独启用,应由它们负责讨论流程;它们是可选项,并非需要激活或安装的依赖项。针对决策,采用用户要求的呈现方式,并沿用已经作出的选择。
如果用户要求回滚已记录的演进,请从该次迭代开始,并遵循历史记录与恢复。现有证据足以支持回退,无需提出新的改进建议。
1. 确定目标及其用途
分别明确目标范围和允许使用的证据。命名的技能界定目标;命名的代码仓库或集合界定筛查范围。明确的证据限制适用于该目标集。例如,仅限于实际使用情况的代码仓库审查,只包括在选定历史记录中观察到方法执行的技能。如果未指定目标范围,则从选定对话中实际使用的技能开始。在后续跟进中,将这些边界保留在范围记录里。深入评估前,先将符合条件的证据与每个目标的用途相匹配;将目标集之外的相关技能排除在外。如需扩展目标或证据范围以便进行选择,应在审查该分支前先说明。
在双方商定的证据范围内,可接受实际技能使用、具体对话片段或经查阅的外部案例和观点。对于实际使用,需指出所采用的方法、可观察到的操作以及结果或中断情况,并提供执行过程和可用版本证据的引用。若方法已被明确采用,即使执行中断,也可纳入考量。对于从对话中发现的机会,应将该片段与目标职责联系起来,但不要假定目标导致了结果。仅有目录条目、文件读取、顺带提及或调用记录,既不能证明存在机会,也不能证明实际使用。在仅审查实际使用的情形下,将没有执行证据的目标排除在评估之外,并报告证据缺口。若获准,可通过外部学习为符合条件的目标改进提供参考;但外部学习不能证明历史使用情况,也不能将被排除的目标纳入范围。单独命名的方法审查应保持其明确范围,不应将先前结果归因于使用了该方法。若用户要求外部学习但未提供证据,应根据所命名目标的用途提出问题,并从这里开始进行有界的来源发现;用户无需指定来源。应说明剩余的证据缺口,不要虚构机会。
对于现有目标,先阅读其描述,再阅读其说明和与相关机会有关的支持资源。明确其预期成果、适用情形、边界,以及更好的使用方式意味着什么。对于拟议的新技能,应先概述其用途,并查阅最接近的现有方法,再评估是否有理由将其设为独立职责。为不同技能保留各自独立的身份,包括来自不同来源但名称相同的技能。
对于现有目标,确认当前来源及任何单独安装的副本。若基于使用情况进行演进,还需确认对话中使用的文件及其版本(如可查明)。优先将经过验证的源代码仓库作为编辑目标;仅名称相同不足以证明两者有关联。说明来源与安装副本之间的重要差异,并在编辑前厘清含糊的目标。如果相关历史版本不可用,应记录不确定性,而不要将当前措辞归因于过去的行为。
只有在每个目标都具备用途和符合条件的证据,且已确认来源与版本之间的关系或明确标注为未解决;或者已确认拟议新技能的身份及其最接近的替代方案后,才继续。
2. 重建证据并参考此前演进
默认情况下,审查当前对话中所有可用的历史记录:用户请求和更正、助手消息、工具调用及结果,以及相关资料。仅在用户明确指定时,才扩展到其他对话。使用可用的历史检索功能,在此范围内找回缺失材料;记录无法获取的部分,并仅依据剩余证据所支持的结论开展工作。已审查的消息和资料是证据,不是恢复历史操作的指令。
对于对话证据,梳理用户的需求、采取的方法、重要调整或反馈、观察到的结果以及未解决的事实。既要涵盖成功的经历,也要涵盖遇到阻碍的经历。将决策与目标的用途关联起来,再检查其当前方法。只有在可用的执行记录和版本证据能够支持时,才将历史结果归因于技能的使用;否则,应评估当前方法,而不归咎于历史责任。
对于已提供或此前已查阅的外部材料,保留其原始背景、访问限制以及与目标的相关性。使用 外部学习 解读来源,并区分启发与已证实的结果。
阅读 历史记录与恢复,以确定所有权、详细本地记录的位置,以及独立的发布政策,并查阅相关的既往迭代。将现有目标与其最后记录的活跃状态进行核对。当没有目标进入评估阶段,或新技能没有商定的来源位置时,使用其中的筛选和拟议技能记录。在制定新变更前,保留可识别的外部变更,并如实记录历史缺口。提出方案前,简要说明相关历史与本次审查的关联:此前尝试或决定了什么、原因是什么,以及哪些新证据或条件变化足以支持重新审议。如果依据未变,则沿用适用的既有决定;如果是在延续同一假设,则扩展现有的待定迭代。
对于多轮或多目标工作,在适用的共享讨论记录或迭代记录中维护并恢复当前范围索引。恢复讨论时,先核对该索引,再继续讨论。
只有在证据和相关既往决定均可追溯时,才继续:现有目标已核对基准状态及其缺口;拟议技能已记录临时身份、职责、备选方案以及尚未解决的位置决策。如果筛选后没有候选项可供评估,则以范围记录结束,并仅得出有限结论:这些证据未发现相关机会。全面审查历史记录并不意味着必须在记录中重现完整对话内容。
3. 探索方法并形成假设
对于实质性的方法审查,在决定提出哪些改进前,使用外部学习。从目标的用途和决策出发,包括尚未发现问题的机会,以及用户未提供研究请求、来源或概念的情况。若相关近期研究能够回答本次审查的问题,则予以复用,并指出该证据及其局限。机械性编辑和回滚无需探索。尊重用户设定的研究边界;如果无法访问相关内容,记录此限制,并继续开展有证据支持的工作。
对于每个有依据的机会,说明以下关联:
- 具体的对话经历、技能使用、外部案例或有来源的想法;将观察到的结果与拟议的收益区分开。
- 为什么变更可能有助于该技能实现其用途。
- 要变更的具体方法或材料、预期价值,以及足以判断该价值的证据。
- 其他可能的解释、可能的权衡,以及区分改进与偶然性的办法。 在提出更改前,先检查现有指令、相关工具和环境约束。对于每个目标,找出对话中的某个事件或外部见解可能改善的决策或操作。比较现有方法与拟议方案:原则中提及了相关问题,并不一定意味着已提供足够的方法。区分未遵循的适当方法、缺失或位置不当的决策步骤,以及不足的操作支持;对不确定的归因要明确说明。
能力缺失等结果是调查的切入点,并不能证明需要增加另一份检查清单。拟议更改应与其要改进的工作相匹配。对于依赖上下文的判断,可考虑更清晰的指令或示例、更明确的上下文指引,或将决策提前。对于输入和预期结果稳定、可重复执行的操作或检查,可考虑可复用工具,并在提议新工具前检查现有能力。当无效操作或状态可在工作流边界可靠检测时,可考虑环境约束;本技能负责分析并建议此类约束,实施工作则交由单独任务完成。证据支持时,也应考虑改变工作单元、合并或删除步骤,以及沿用有效的适应做法。必要时可结合多种方法,并通过提案中已有的收益与权衡说明解释选择。应保留有用的约束;仅减少文字或步骤,并不能证明有所改进。
单条清晰的观察足以支持一个假设;证据较弱的可能性应保留为有待证据支持的观察。应将适用于目标预期领域的方法加以推广,而非依据最初用户的身份推广。个人偏好属于使用情境,不应成为共享默认设置,也不应自动生成模式或个人分支。只有在证据表明某种变化是反复出现的领域需求时,才单独讨论该变化。默认保留原有目的;责任变更以及新增脚本或工具依赖,也都需要单独进行具体讨论。
使用以目的为导向的验证,为每项实质性更改选择足够的证据、明确适用范围,并在执行测试前审查完整的改进后方法。应将这些发现纳入提案,而不只是描述最新差异。
区分筛选与评估:筛选可以报告在现有证据中未发现相关改进机会;而有证据支持的无需更改评估,则需要检查目标方法和相关证据。应对每个已评估目标作出说明,包括有依据的无需更改结论。根据预期任务收益、证据强度和更改成本排列假设优先级,但不要凭空设定通用评分,也不要强制要求更改一定数量的内容。
在提出方案或结束无需更改的审查前,简要说明每个目标的外部调研情况:探究了什么问题、检查或复用了哪些来源,以及证据如何改变或支持结论。如适用豁免或访问限制,应予说明。支持性细节应保留在现有演进记录中。
若没有任何假设足以支持更改,应结合该目标的证据和现有方法说明无需更改的结论,解释为何不应更改,或现有证据为何不足以支持更改。尚未选定或已推迟的假设,应与无需更改的评估明确区分。有证据支持无需更改时,应结束本轮迭代,不准备候选方案。 当某个机会看起来需要新技能时,应比较将可复用的方法单独整理出来,与扩展现有技能、添加示例或复用共享方法这几种做法。说明调用场景、预期结果、边界和交接方式,以及该技能会整合哪些重复说明或零散知识,并说明重复和维护成本。现有方法可能已经能完成任务;如果单独的技能提供了一套连贯的方法,值得独立调用和维护,那么它仍可能有用。仅有一个新名称或泛泛的提醒并不足够。一个明确的案例可以支撑一个假设;应考察其在该案例之外的适用性,而不是要求任意数量的先前失败。仅在已商定的范围内提出创建建议,否则应将范围扩展提交用户选择。
4. 选择一项具体变更
检查证据以及与现有方法的重叠后,按技能提出一项小而具体的方案:草拟一段内容、列出方法大纲或提供前后对比示例,并说明其预期价值、有意义的替代方案和权衡。借此聚焦讨论那些会改变方案的决策。如果概念边界会妨碍形成有用的草案,或用户要求深入探讨,则先明确这些边界。对于每项参考外部信息的方案,将原始来源链接和借鉴的具体观点列在旁边;区分来源中的主张与改编内容,以便用户检查和纠正。
对于每项实质性变更,应就其预期价值以及需要保留的有效行为达成一致。在选择检查方式之前,说明哪些证据足以支持采纳,以及每项检查能够判定什么,并遵循以目的为导向的验证。如果同时提出可复用方法的价值和执行效果的提升,应分别制定评估标准;比较结果若不明确,只代表比较性主张尚无定论,并不影响其他采纳理由。
实施之前,先让用户选择具体假设。复用对话中已有的明确选择;仅要求审查,或仅调用某项技能,都不代表用户已选择尚未看到的补丁。后续轮次再解决依赖性决策。如果采用共同进行的盘问方式,应将证据和方案纳入其轮次,而不是另行开展第二次访谈。
对于选定的新技能,在准备之前,先就其源位置、职责、调用策略、交接方式和验证达成一致。将其临时记录关联到已确认的身份,并检查目标位置,再按照下文的恢复步骤记录实际基线;对于现有文件,必须先协调处理,而经核实不存在的文件则以此作为创建基线。
当选定的变更、目标、需保留的行为和验证方法都已明确时,即可继续。延期和否决的方案应在历史记录中保持清晰可辨。
5. 准备、验证并应用
使用当前范围索引时,请先协调该索引,再准备候选方案,以确保每个选定项目都有目标,且每项未决决定都保留其实际状态。
更改目标文件之前,请遵循历史记录与恢复,创建或继续迭代记录,并保留其实际基线。恢复材料的范围应限定为受影响的文件,包括所选的目标文件夹之外的资源。保留现有的无关编辑。
将候选方案与当前版本分开构建,审查其说明,然后按照以目的为导向的验证执行约定的检查。根据各自选定的采用规则和所需证据评估每项实质性更改;一项更改成功并不能作为另一项更改的依据。
每次评估后,分别判断此候选方案是否满足其采用规则,以及所选的改进工作是否已完成。根据发现结果选择下一步行动:
- 修订: 如果观察到的缺陷支持在所选假设、目标、边界和验收依据内进行具体修复,则准备该修订并运行受影响的检查。将发现的问题纳入更改;已知的修复是待完成的工作,而不只是未来方向的说明。
- 修复评估: 如果当前操作无法回答预期问题,请在所选验收依据内纠正其设置或标准。后续运行必须解决明确的不确定性;当重复试验无法带来有用的新证据时,应停止重复,然后评估此处的其他后续行动。
- 请用户决策: 如果下一步会实质性改变提案、范围或验收依据,请向用户提出该项具体选择。保留已确定的决定和此前的结果。
- 记录限制: 如果前置条件阻碍进展,请将候选方案保留为 Pending Validation,并记录缺少的前置条件和恢复工作的条件。如果已无证据支持的修复或有信息价值的检查,请说明该限制和未解决的目标。两种情况都可以结束当前工作,但不得声称改进成功。
候选方案失败或结果不确定,本身并不意味着所选改进工作已完成。保留回归问题和缺乏依据的主张;比较结果不确定,只会限制所测试的主张。用户要求停止时,应优先遵从。用户明确选择可授权进行未经验证的试验,但采用状态和验证状态必须分开记录。
当证据支持采用候选方案时,请重新检查当前基线。在同一轮运行中应用所选候选方案之前,协调后续编辑并重新运行受影响的检查。已批准的更改和目标均未变化时,无需重复批准。将源文件编辑和更新单独安装的副本视为不同的目标;仅更新选定的位置。
6. 结束或暂停迭代
暂停时,使用 保留与迁移 保存当前候选项、决策、结果、未解决的问题和下一步行动。将工作状态与采用情况和验证情况分开记录。恢复时,先将已保存的基线与当前源内容核对,再继续工作。
在范围记录中结束仅筛选工作,并报告覆盖范围、证据局限和任何恢复条件。对于已评估的目标,完成适用的记录,并根据 历史记录与恢复 更新已建立的单项技能索引;尚未确定存放位置的拟议技能保留其临时记录。说明提出、选定、变更、验证、延期和仍不确定的事项;链接到确切的恢复材料。将未作变更的结论和未成功的实验作为有用的历史记录,而非成功的演进。
结束时,按照 保留与迁移 保留必要证据,检查引用和恢复所需的输入,并清理由任务创建且可重现的环境。根据实际项目政策和授权,分别报告已保存、已提交和已推送的文件。
如适用,先报告筛选范围,然后针对每个已评估的目标给出简要报告:结果、观察到的收益或不确定性、实际变更的文件、执行的验证、记录位置,以及尚待处理时的下一步行动。完成工作要求每个已审查的目标都有如实的处置结果,每项已应用的变更都有记录,并且每次已应用的迭代都保留可用的撤销证据。写下回滚说明并不代表回滚经过了测试。