SuperAPI AI 工具集

skill-session-review

智能体与模型

查看项目

更新于 10-15 20:05

技能介绍

用途:审查某个已存在的 skill 在真实会话中被遵循的情况,并持久化一份反馈报告。适用于用户要求分析某 skill 的使用情况时。

主要能力:扫描会话中的调用信号,读取目标 SKILL.md(只读)与被调用的会话片段,按 finding 契约填写发现;仅当至少两个被调用会话出现同一模式时才将其提升为 pattern。loaded 与 available 只视为覆盖情况,不作为必须修改的证据。

使用方式:<skill-dir> 为该 skill 的基础目录,加载时会公布,需替换为实际路径;Windows 上可用 py -3 替代 python。先解析目标:给路径则用该实例,给名称且存在多个 SKILL.md 时列出路径并停止。再解析当前仓库根:git rev-parse --show-toplevel 或用户指定的根。扫描会话:python "<skill-dir>/scripts/scan_invocations.py" --skill-name <name> [--skill-path <abs>] --scope global --repo-root <abs>;仅当用户要求限定本仓库时才用 --scope cwd。写报告:python "<skill-dir>/scripts/write_session_review.py" --repo-root <abs> --skill-name <name> [--skill-path <abs>] --input <utf8-md>;Windows 优先用 --input 而非 stdin。助手会在仓库根 .gitignore 缺少 reports/skill-session-review/ 这一精确行时追加,不执行 git add。聊天输出仅一行结论、报告路径和一个含交接提示的文本围栏,不粘贴 SSR 表。

限制:不得写入目标 skill 目录,不得输出 diff.patch 或编辑目标 SKILL.md,不得运行 qiaomu-meta,不得在对话中打印完整私密聊天,报告只用短摘录。仅通过上述 helper 写入报告文件、.gitignore 精确行和 --input 临时文件。统计使用次数或删除未使用 skill 不属于本 skill;恢复历史聊天用 resume-claude / resume-codex / resume-cursor;优化 CLAUDE.md 或 AGENTS.md 用 claude-context-improver / agents-md-improver;从材料创建或重写 skill 用 qiaomu-meta,并在后续轮次使用交接提示。