dual-axis-skill-reviewer

双轴技能审查器

运行双轴审查脚本，并将报告保存到 reports/。

脚本支持：

• 随机或固定选择技能
• 自动轴评分，并可选择执行测试
• 生成 LLM 提示词
• 合并 LLM JSON 审查结果并计算加权最终分数
• 通过 --project-root 跨项目审查
• 非评分式显示 skills-index.yaml 中的生产验证声明

使用场景

• 需要对 skills/*/SKILL.md 中的某项技能进行可复现评分。
• 最终分数低于 90 时，需要获取改进项。
• 需要同时进行确定性检查和定性 LLM 代码／内容审查。
• 需要从命令行审查其他项目中的技能。

前置条件

• Python 3.9+
• uv（推荐——通过内联元数据自动解析 pyyaml 依赖）
• 对于测试：在目标项目中运行 uv sync --extra dev 或等效命令
• 对于 LLM 轴合并：符合 LLM 审查架构的 JSON 文件（参见资源）

工作流

根据当前上下文确定正确的脚本路径：

• 同一项目：skills/dual-axis-skill-reviewer/scripts/run_dual_axis_review.py
• 全局安装：~/.claude/skills/dual-axis-skill-reviewer/scripts/run_dual_axis_review.py

以下示例使用 REVIEWER 作为占位符。请设置一次：

# If reviewing from the same project:
REVIEWER=skills/dual-axis-skill-reviewer/scripts/run_dual_axis_review.py

# If reviewing another project (global install):
REVIEWER=~/.claude/skills/dual-axis-skill-reviewer/scripts/run_dual_axis_review.py

第 1 步：运行自动轴并生成 LLM 提示词

uv run "$REVIEWER" \
  --project-root . \
  --emit-llm-prompt \
  --output-dir reports/

审查其他项目时，将 --project-root 指向该项目：

uv run "$REVIEWER" \
  --project-root /path/to/other/project \
  --emit-llm-prompt \
  --output-dir reports/

第 2 步：运行 LLM 审查

• 使用生成的提示词文件：reports/skill_review_prompt_<skill>_<timestamp>.md。
• 要求 LLM 返回严格的 JSON 输出。
• 在 Claude Code 中运行时，让 Claude 担任协调者：读取生成的提示词，生成 LLM 审查 JSON，并将其保存以供合并步骤使用。

第 3 步：合并自动轴和 LLM 轴

uv run "$REVIEWER" \
  --project-root . \
  --skill <skill-name> \
  --llm-review-json <path-to-llm-review.json> \
  --auto-weight 0.5 \
  --llm-weight 0.5 \
  --output-dir reports/

第 4 步：可选控制项

• 固定选择以确保可复现：--skill <name> 或 --seed <int>
• 一次审查所有技能：--all
• 跳过测试以快速初步筛查：--skip-tests
• 更改报告位置：--output-dir <dir>
• 提高 --auto-weight，以实施更严格的确定性门控。
• 当优先考虑定性／代码审查深度时，提高 --llm-weight。

输出

• reports/skill_review_<skill>_<timestamp>.json
• reports/skill_review_<skill>_<timestamp>.md
• reports/skill_review_prompt_<skill>_<timestamp>.md（启用 --emit-llm-prompt 时）

当目标项目的 skills-index.yaml 条目包含完整的 verification 块时，JSON 和 Markdown 报告还会显示其中声明的轴、not_verified 缺口、不适用的轴，以及 all_applicable_axes_passed。此部分仅供参考，不计入自动轴、LLM 轴或最终分数，也不能替代实时的高严重性问题检查。

安装（全局）

若要在任何项目中使用此技能，请将其符号链接到 ~/.claude/skills/：

ln -sfn /path/to/claude-trading-skills/skills/dual-axis-skill-reviewer \
  ~/.claude/skills/dual-axis-skill-reviewer

完成后，Claude Code 将在所有项目中发现此技能，且可通过 ~/.claude/skills/dual-axis-skill-reviewer/scripts/run_dual_axis_review.py 访问该脚本。

资源

• 自动轴评估元数据、工作流覆盖率、执行安全性、产物是否存在以及测试健康状况。
• 自动轴可检测 knowledge_only 技能，并调整脚本／测试预期，以避免不公平的扣分。
• LLM 轴评估内容质量深度（正确性、风险、缺失逻辑、可维护性）。
• 最终分数为加权平均值。
• 如果最终分数低于 90，则必须提供改进项，并将其列在 Markdown 报告中。
• 脚本：skills/dual-axis-skill-reviewer/scripts/run_dual_axis_review.py
• LLM 架构：references/llm_review_schema.md
• 评分标准详情：references/scoring_rubric.md