用途:lookout-companion 用于把结构化、可视化或长时间运行的输出推送到 Lookout TUI 可视化器,供用户在另一个窗格中扫视,聊天则专注于散文式交流。Lookout 运行在 http://127.0.0.1:9477/mcp。
触发条件(每次出现即推送,规则优先于主观判断):Git 操作前推送 show_status 卡片,说明即将执行的动作与当前分支状态(ahead/behind、脏文件),操作完成后更新同一张卡片;运行测试或构建时,用 show_log 推送原始输出或用 show_status 推送汇总(通过/失败数、耗时),复用同一 pin 位更新而非新建卡片;产生表格、树、diff 或超过约 5 项的列表时,改用对应的 show_* 卡片,聊天只留一行摘要;派发子代理前用 show_status 说明委托事项与对象,返回后先以卡片推送发现再整合进回复;多步任务(超过约 3 个子步骤)开始时用 show_status 列出步骤与状态,并随进展更新。
不应推送:琐碎确认(如读取文件、ls)、自己的散文、密钥/凭据/.env 内容、用户的直接提问(先在聊天中回答)。
卡片类型:show_text(文本/markdown/代码)、show_table(行列可比数据)、show_chart(时间序列或柱状图)、show_tree(层级结构)、show_diff(代码/文本差异)、show_log(可追加日志行)、show_image(本地 PNG/JPG)、show_progress(0..1 单值,可带标签)、show_status(多字段键值状态)、show_question(一眼可判的是/否,谨慎使用)。
约定:会话开始时调用一次 set_session_label,给出简短的人类可读标签(如“auth refactor”),便于区分并行会话;用 card_id 复用并更新已有卡片,进度和状态卡片尤其应原地更新;推送摘要而非洪流,14 个调用方应放在一张 show_table 中;不要试图预测用户会 pin 哪张卡片,只需确保存在值得 pin 的内容。
限制:资料未说明该技能的安装方式、收费情况或具体平台依赖;规则要求按触发条件推送,不适用于琐碎操作、密钥和用户直接提问。