用途:capture-learning 用于把一次已经解决、经过验证且不显而易见的问题,整理成一份后续工程师可查找、可使用的解决方案文档。每次运行只捕获一个学习点;若证据不达标,不写弱文档。在 mode:headless 下返回“Documentation skipped”并给出原因;交互式运行仅在已解决问题本身不清楚时提问。
主要能力与做法:读取相关对话证据、已更改的源码、验证结果和附近已有的解决方案文档,其中源码与捕获到的命令结果优先于会话回忆。依据 references/schema.yaml 与 references/yaml-schema.md 对学习点分类并选择存放位置,按 references/resolution-template.md 规定的正文结构撰写。检查是否已有同一问题的文档:若问题、原因、解决方案实质一致则更新,保持路径稳定;否则新建一份。每条行为声明都需用 file:line 引用当前源码作为依据;仅在经核实后描述合并状态,无法验证的声明要注明来源或删除。仅当现有 CONCEPTS.md 存在符合条件的缺失术语时,才读取 references/concepts-vocabulary.md 并更新该条目,且词典变更限于本次学习点的领域。运行 scripts/validate-frontmatter.py 与 scripts/validate-doc-claims.py 进行校验,并按 references/grounding-validation.md 裁定标记,逐一修复、注释或确认,不得静默忽略;若校验器无法运行,执行其文档化的手工检查并报告该回退。
使用方式:技能仅写解决方案文档本身,不创建词典、不编辑项目指令、不搜索无关记忆,也不把本次运行变成文档审计。frontmatter 与声明校验脚本需从本技能所在目录运行:scripts/validate-frontmatter.py、scripts/validate-doc-claims.py。headless 模式仅在调用方提供已验证修复且上下文足以识别一个学习点时使用,结束时以“Documentation complete”或“Documentation skipped”作为终止行。
适用场景:被要求记录已解决问题,或交付流程选择 learning capture 时。
限制:不描述未经验证的事实;每次只捕获一个学习点;不处理与本学习无关的文档工作。关于收费、价格、平台支持或具体效果,资料暂未提供。