用途:这是一个“发现技能机会”的技能,帮助判断某个仓库里哪些重复手工流程值得写成技能。适用于回答“这个仓库该写哪些技能”、审计代码库中的可自动化工作流、了解陌生仓库的固定仪式,或在动手写技能前先用真实证据打底。它不负责撰写技能本身,选好候选后交给 superpowers:writing-skills;也不适用于一次性、无重复的任务。
主要能力:从两类独立证据挖掘。其一是仓库证据,脚本 git-signals.sh 分析 git 历史(提交前缀、关键词、热点文件、共同变更对、繁忙目录);scan-workflows.sh 盘点已有的工作流编码(Makefile、package.json 脚本、任务运行器、CI、scripts/、runbook 文档及已有技能)。其二是会话证据,session-signals.py 分析本地 Claude Code 转录(请求聚类、关键词、工具序列 n-gram、热点文件、共同编辑对、所用技能、摩擦点)。两者各有盲区:git 只看最终提交,会话只看本机转录,因此默认同时运行以求相互印证。
必要用法:脚本均为只读、确定性。git 信号:bash "${CLAUDE_SKILL_DIR}/scripts/git-signals.sh" --repo <path> --days 30 --top 20,可用 --since "1 year ago"。工作流盘点:bash "${CLAUDE_SKILL_DIR}/scripts/scan-workflows.sh" --repo <path>。会话信号:uv run python "${CLAUDE_SKILL_DIR}/scripts/session-signals.py" --repo <path> --days 30 --top 20,--scope all 可忽略仓库归属。默认仓库为当前目录,回溯 30 天,来源 both,每节 20 行。
候选筛选标准:反复发生、多步骤、易错易忘、涉及判断、可复用、且尚非已有技能;一次性的、已全自动化无判断的、纯项目琐事的应剔除。输出为排序报告,每条含证据(带计数并标注来源)、流程、为何值得写成技能、下一步。报告开头需写明所用来源、回溯窗口与规模,结尾列出已考虑但被拒绝的信号。
限制与注意:会话转录含用户自己的提示词,可能引用客户材料,脚本只读取,但输出可能含提示片段,对外分享或提交时用 --no-examples。会话仅覆盖本机转录,git 仅覆盖已提交工作,应明确说明两个局限。三个脚本默认当前目录、输出排序且无墙钟时间戳,同一窗口与输入下多次运行结果完全一致。若某脚本无法运行(缺 bash、无 Python、无转录目录或系统不同),应运行可行的部分并说明跳过原因。