2.5 KiB
TASK-08 研究来源与维护 skill
适用：分析优秀文档、引入新的写作方法、增强手册、调整任务路由，或根据真实失败改进 skill。
必读：DOC-020、DOC-022、DOC-023、DOC-024、行为评估。
从具体缺口开始
记录当前作者在哪类任务中作不出决定。例如知道“例子要完整”，却不知道依赖声明、归属和提案状态怎样放在成稿里。对应改进应提供一个完整示例和判断方法，不只是新增同义规则。
将新增内容放在最小合适位置：共同决策放 SKILL.md；任务特有步骤放任务页；详细判断放方法页；真实示范放 examples；来源事实留在 research。已有 DOC 编号保持稳定。
处理外部来源
读取指定原页，记录原 URL、日期、可定位章节与可观察做法。分开写页面事实、效果分析和项目采用方式。读取失败的来源保留状态，不用同名文章或搜索摘要替代正文。
新增建议先解释它解决的项目问题，再确定适用任务和边界。不能因为某站有复杂目录就把相同层数复制进项目，也不能把成熟语言的能力移植为本语言规则。
维护阅读地图
改变任务必读项时，同步 SKILL.md 的任务表、手册目录与相关 DOC 页的深读链接。入口应让作者知道为什么读这一页以及读后做什么。
任务查询、规则阅读和写作默认通过 Markdown 完成。新增工具须有明确任务需要和用户要求；手册不能把执行脚本、测试或安装依赖变成隐含步骤。
行为验证
选择与修改相关的现实任务，按 skill 走完并保存输入、产物和判断。可以使用隔离的样稿，避免测试污染正文。检验是否选对页面、保留语义边界、给出可核对成稿、尊重只读审查范围。
人工检查文件入口、元信息和链接；代码形式的验证仅在用户明确要求时执行。作者走查、独立代理评估、真人试用分别报告；没有进行的层级不得声称完成。
完成与维护
修复评估暴露的问题后再交付；在维护记录中写明变更动机和实际验证。不要为一个偶发例子堆积全局禁令。
一旦任务路由清晰、方法足以改变写作决策、示例可复用且选定场景达到预期，就可以发布本次改进。后续根据真实使用持续修订，而不是等待覆盖所有可能情况。