huangwb8

install-bensz-skills

@huangwb8/install-bensz-skills
huangwb8
3
0 forks
Updated 1/18/2026
View on GitHub

name: install-bensz-skills

Installation

$skills install @huangwb8/install-bensz-skills
Claude Code
Cursor
Copilot
Codex
Antigravity

Details

Repositoryhuangwb8/skills
Pathinstall-bensz-skills/SKILL.md
Branchmain
Scoped Name@huangwb8/install-bensz-skills

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

skills list

Skill Instructions


name: install-bensz-skills category: auxiliary description: 当需要把本仓库 pipelines/skills 下的所有 skills 安装到系统级(Codex: ~/.codex/skills;Claude Code: ~/.claude/skills),以便在任意项目/对话中可被发现与调用时使用。使用 MD5 哈希进行版本控制,仅安装有更新的 skills;支持强制覆盖安装和单独目标安装。

Install Bensz Skills(系统级安装器)

目的:把当前仓库 pipelines/skills/ 中的所有 skills(不包括 install-bensz-skills复制安装到:

  • Codex:~/.codex/skills/
  • Claude Code:~/.claude/skills/

从而让这些 skills 在任意项目里都能被发现与触发(不依赖当前 workdir,也不使用软链接)。

你要做的事(触发后必须执行)

  1. 运行安装脚本:
# 默认:同时安装到 Codex 和 Claude Code(仅安装有更新的)
python3 install-bensz-skills/scripts/install.py

# 仅安装到 Claude Code
python3 install-bensz-skills/scripts/install.py --claude

# 仅安装到 Codex
python3 install-bensz-skills/scripts/install.py --codex

# 强制重新安装所有 skills(忽略版本检查)
python3 install-bensz-skills/scripts/install.py --force

# 预览模式(不实际安装)
python3 install-bensz-skills/scripts/install.py --dry-run
  1. 验证(建议在任意其它目录执行):
codex exec "列出所有可用的技能"

MD5 版本控制机制

脚本使用 MD5 哈希值进行智能版本控制:

  • 版本计算:计算每个 skill 目录中 SKILL.md 的 MD5 哈希值作为版本标识
  • 版本存储:安装后在目标目录生成 .skill-manifest.json 记录版本信息
  • 智能安装
    • 已安装且版本未变:跳过,不重复安装
    • 版本已变化:强制覆盖安装
    • 新 skill:直接安装

安装报告示例

============================================================
📦 正在安装到 CLAUUDE: /Users/xxx/.claude/skills
============================================================

removed legacy symlink: /Users/xxx/.claude/skills/pipeline-skills
installed: /Users/xxx/.claude/skills/nsfc-abstract-writer
installed: /Users/xxx/.claude/skills/nsfc-aims-writer
installed: /Users/xxx/.claude/skills/zcf:git-commit

📊 安装摘要 - CLAUUDE
============================================================

✅ 已安装/更新 (3 个):
   • nsfc-abstract-writer
     MD5: a3f5e8d9c2b1f4a6e7c8d0b1a2f3e4d5
   • nsfc-aims-writer
     MD5: b4e6f9a0d3c2e5f7a8b9c1d2e3f4a5b6
   • zcf:git-commit
     MD5: c5d7a0b1e4d3f6a8b9c2d3e4f5a6b7c8

⏭️  跳过 (15 个):
   • nsfc-bib-manager
     原因: 版本未变化
   • nsfc-foundation-conditions-writer
     原因: 版本未变化
   ...

============================================================

安装策略(脚本保证)

  • 仅安装"包含 SKILL.md 的目录"(即每个 skill 的根目录)。
  • 排除install-bensz-skills
  • MD5 版本检查:优先检查 .skill-manifest.json,回退到重新计算
  • 直接替换:发现到目标路径已存在同名目录且版本变化时,直接删除旧版本并安装新版本(不备份)
    • 理由:Git 已提供版本控制,可随时回退;新版本通常比旧版本更好
  • 若存在旧的 pipeline-skills 软链接:会移除该软链接(不删除真实目录)。

命令行参数

参数说明
--dry-run预览模式,不实际写入文件
--codex仅安装到 Codex
--claude仅安装到 Claude Code
--force强制重新安装所有 skills(忽略 MD5 检查)

常见问题

  • 如果你刚更新了本仓库的技能:再次触发本 skill 运行脚本即可完成系统级更新(仅安装有变化的)。
  • 需要强制重装:使用 --force 参数。
  • Claude Code / Codex 都需要新会话才会重新加载更新后的技能;安装后建议新建会话验证。
  • 如何回退到旧版本:使用 Git 回退源代码后,重新运行安装脚本即可(不备份旧版本)。

More by huangwb8

View all
make-latex-model
611

基于 NSFC 最新 Word 模板高保真优化 LaTeX 模板样式(集成测试工具,标准化测试流程)

transfer-old-latex-to-new
611

智能迁移旧版NSFC标书到新版模板:分析旧新项目结构、AI自主规划迁移策略、执行内容迁移、迭代优化、编译验证。用于用户要求"迁移标书/升级模板/跨版本迁移/旧标书转新模板"。

auto-test-project
3

项目级自动化测试驱动优化技能 - 用于对完整项目(如 skill、workflow、或类似 init-project 定义的流程项目)进行持续性 AI 优化。 **核心能力**: - 支持多轮 A 轮迭代:分析 → 计划 → 优化 → 轻量测试(可重复 N 次) - **独立评估模式**:每轮 A 轮默认不查看历史 `plans/`/`tests/`,基于当前项目状态独立审查,降低确认偏差(口径以 `config.yaml:a_round_check.independent_review` 为准) - **批判性思维门槛**:每轮至少 3 个系统性问题(架构/过度设计/一致/安全等),且 P0+P1 占比 ≥ 60%(口径以 `config.yaml:test_rounds.*` 为准) - A 轮结束后执行 B 轮质量检查:维度以 `config.yaml:b_round_check.dimensions` 为准 - 规范化测试会话命名:`vYYYYMMDDHHMM` - 将每轮产出固化为文档与目录(可追溯、可复现、可复盘) - 项目级优化:从单个 skill 扩展到完整项目(多文件、多模块、跨目录) - **强制验证机制**:确保计划与执行的一致性,防止"假计划、空报告" - **模板自动替换**:创建测试会话时自动替换模板变量,消除人工填写错误 - **强制数量要求**:每轮至少 10 个问题,鼓励 15-25 个

auto-test-skill
3

自动化测试驱动优化技能 - 用于在技能/项目迭代时,通过多轮 A 轮批判性测试 + B 轮质量原则检查(以 `config.yaml:b_round_check.dimensions` 为准), 系统化发现、记录、修复问题,并沉淀可追溯的 `plans/` 与 `tests/` 文档。 **核心能力**: - 支持多轮 A 轮迭代:分析 → 计划 → 优化 → 轻量测试(可重复 N 次) - **独立评估模式**:每轮 A 轮基于当前状态独立审查,不查看历史 `plans/`/`tests/`,降低确认偏差 - **批判性思维驱动**:强制使用"刁钻角度"思考,每轮至少 3 个系统性问题(架构/过度设计/一致/安全) - **强制质量要求**:每轮 A 轮至少 10 个问题(鼓励 15-20 个),P0+P1 占比 ≥ 60%,B 轮至少 10-20 个建议 - A 轮结束后执行 B 轮质量原则检查:维度以 `config.yaml:b_round_check.dimensions` 为准(当前为 8 项) - 规范化测试会话命名:`vYYYYMMDDHHMM` - 将每轮产出固化为文档与目录(可追溯、可复现、可复盘)