用途:当某个技能的输出与用户预期不符,且原因在于技能本身的误解、缺失规则或系统性错误时,充当技能库的反馈与学习闭环:收集证据、草拟 issue,经用户同意后提交给维护者。不修复技能、不重跑技能。
触发条件:需同时满足——本对话中先前使用过某技能;用户要求修改其输出;根因在技能而非用户输入或一次性歧义。若只是用户细化自身需求、主观偏好或一次性调整,则不触发。
输入参数:skill_name(必填)、observed_output(必填)、expected_output(必填)、root_cause(必填)、attribution(可选,named 默认或 anonymous)。
工作流程:先与用户确认是否记录反馈;随后阅读技能的 SKILL.md 及相关引用文件做根因分析,向用户确认;再用 references/issue-template.md 草拟 issue 供审阅;然后询问具名或匿名;用户批准后提交,并回报 issue URL;最后可询问是否保存本地反馈记忆。
提交方式:具名使用用户自身 gh 账号,命令为 gh issue create 带仓库、标题、标签与正文;匿名通过 ol-ai-context-library GitHub App 机器人,先运行 SKILL_FEEDBACK_BOT_TOKEN=$(python3 ~/.config/ol-skill-feedback/get-token.py) 获取短期令牌,再以 GH_TOKEN 方式提交。令牌脚本失败时可退回为输出 markdown 供手动粘贴。相关配置:App ID 3488823、Installation ID 126702693、私钥与脚本路径见资料。
对比模式:用于方法论学习。当用户有另一框架的等效技能输出,或明确要求针对某框架做严谨性对比时触发。需在相同输入上对比,按 references/comparative-rigor-rubric.md 逐维度 1–5 打分并附证据,提炼差距与优势,按 references/comparative-issue-template.md 草拟 issue,同样需批准后提交。仅评输出严谨性,不作风格偏好比较。
限制:不修改技能文件、不重跑技能、未经明确同意不提交 issue;不收集超出用户自愿提供范围的个人信息。若用户想立即修复,应自行编辑 SKILL.md 或提 PR。输出固定展示反馈摘要,含技能名、缺陷、根因、建议修复、issue 状态与记忆保存情况。具体仓库地址与部分引用文件内容资料未完整提供。