用途:knowhow-run 是 knowledge-engine 的主动执行入口,用于查找、加载并遵循 .knowhow/ 中已沉淀的 skill 或 workflow。与 knowhow-query 的区别在于:query 面向“需要知道/查阅”的 wiki 知识,run 面向“需要按既定流程执行”的可操作知识。
主要能力:支持三种输入。给出具体名称(如“运行 skill parse-invoice”)时跳过查找直接加载;给出任务描述时先匹配注册表;输入为空时列出可用 skill/workflow 供选择。匹配优先级为 trigger 字段、描述、tags,必要时用 grep -ril "<关键词>" .knowhow/skills .knowhow/workflows 搜索。加载时读取 .knowhow/skills/<slug>.md 或 .knowhow/workflows/<slug>.md,子目录结构用 find 递归定位。执行 workflow 遇到 [[X]] 引用时,解析到子 skill 文件并递归加载执行,无需编排器。
使用方式:先确认工作区存在 .knowhow/,可用 ls -d .knowhow/ 2>/dev/null 检查;不存在则提示先运行 knowhow-init。执行完成后向 wiki/log.md 追加一行使用日志;若因缺少 skill 而按 wiki page 执行,则向 .knowhow/schema-signals.md 写入一行 promote-candidate 信号。
限制:必须完整读取文件后再执行,禁止只看注册表一行就臆造步骤;不得虚构不存在的 skill;执行阶段不修改 wiki/skill/workflow,发现问题只记录并建议用 knowhow-distill 精炼;新经验须经 knowhow-capture 进入 inbox。deprecated 状态会警告,archived 不建议运行,子 skill 链接失效则停止并建议 knowhow-lint quick。注册表为空时提示尚无沉淀内容。