Agent Skills
返回列表
💻

双轴技能评审器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/tradermonty-claude-trading-skills-dual-axis-skill-reviewer。

技能介绍

问题背景

维护 skills/*/SKILL.md 时,单靠人工通读很难在结构元数据、脚本可执行性、测试健康度与内容逻辑、风险与可维护性之间做一致、可复现的打分。单轴启发式检查容易漏掉「声明了验证块但实际未跑通」的缺口,纯 LLM 观感又缺少确定性门槛。

工作方式

本技能通过 run_dual_axis_review.py 跑双轴评审并落盘到 reports/:自动轴覆盖元数据、工作流覆盖、执行安全、产物存在与可选测试;对 knowledge_only 类技能会调整脚本/测试预期,避免不公惩罚。LLM 轴用生成的 skill_review_prompt__*.md 做深度内容与代码质量审查,要求严格 JSON 输出后与自动轴按权重合并为最终分。

典型流程分三步:先跑自动轴并 --emit-llm-prompt;再用提示词让模型产出符合 schema 的 LLM 评审 JSON;最后 merge 得到 skill_review__*.json 与 Markdown 报告。需要固定复现时可用 --skill 或 --seed;扫全库用 --all;快速摸底可 --skip-tests;评审别的仓库时把 --project-root 指过去即可(本仓或 ~/.claude/skills/ 下的全局安装路径二选一)。

边界与注意点

若目标项目 skills-index.yaml 里带有完整 verification 块,报告会仅展示声明轴、未验证缺口等,不计入自动/LLM/最终分,也不替代线上高严重度问题检查。最终分低于 90 时,Markdown 报告会强制列出改进项。LLM 合并步骤依赖 references/llm_review_schema.md 约定的 JSON;在无 dev 依赖的环境下测试轴可能受限,需按 SKILL 要求 uv sync --extra dev 等准备。

使用场景

  • 合并 PR 前要对某一个 `skills/foo/SKILL.md` 做固定种子复现打分,并留档 JSON/Markdown 报告
  • 技能库例行巡检:用 `--all` 批量跑自动轴,再只对低分条目生成 LLM 提示词做深度审查
  • 维护的 SKILL 在别的 monorepo 里,需在本地 CLI 指定 `--project-root` 跑完整三步 merge 流程
  • 对照 `skills-index.yaml` 的 verification 声明,在报告中核对未验证轴与缺口,但不把它当最终分依据

适合人员

  • 负责 Claude/Code 技能目录 CI 的维护者,需要把低于 90 分的改进项写进合并门禁说明
  • 在多仓库复用同一套 skills 的工程师,想从全局 `~/.claude/skills/` 脚本评审任意 `--project-root`
  • 写 SKILL 时兼任测试的作者,需要在不打断流程下用 `--skip-tests` 先筛结构问题再补跑测试轴
  • 用 LLM 做内容审校但希望保留确定性检查的编辑,需要调 `--auto-weight` / `--llm-weight` 平衡两轴