Bensz Agent Skills

让 Agent Skill 从文件，变成系统。

一套遵循 Agent Skills 开放标准 的可复用 Skill 集合、开发流水线，以及帮助检查和追踪 Skill 执行过程的工具。

快速开始 · Skill 导航 · Kernel · 开发与验证 · English

Bensz Agent Skills 项目把 Skill 的创建、测试、文档、安装与发布连成可复用的工程流程；更进一步，执行内核bensz-skill-kernel（简称BSK）尝试回答：当 Skill 成为 Agent 系统的长期组成部分时，该用的时候它用上了吗？该做的步骤漏掉了吗？改动之后变差了吗？出错时，能查到是哪一步吗？

项目在做什么

项目由三部分组成：

• 可直接使用的通用 Skills：覆盖自动测试、多 Agent 协作、并行工作区、Prompt 优化、科研绘图、Git 操作、安装、文档和缺陷反馈。
• Skills 开发与维护流水线：用统一约定串起开发 → 测试 → 文档化 → 安装 → 使用 → 反馈 → 迭代。
• Skill 执行与检查工具：bensz-skill-kernel 正在提供任务阶段管理、自动检查、工作区、证据记录、事件账本、审计和执行记录重放。

这些工具不试图把 Skill 变成传统程序，而是让复杂 Agent 工作流中的关键阶段、检查和证据更明确、更容易追踪。

为什么做这个项目

当 Skill 数量和流程复杂度增长，仅靠更长的 SKILL.md 很难回答：Skill 是否正确触发、是否遗漏步骤、修改后是否退化、协作过程是否可追踪、结果经过了哪些检查，以及失败发生在哪里。本项目因此尝试把关注点从“编写单个 Skill”推进到更完整的 系统化建设 Skill。

设计原则

• 开放标准优先，尽量不绑定单一平台。
• Skill 与通用工具分离：具体工作流程留在 Skill，通用的执行、检查和记录功能放在 Kernel。
• 显式状态优于隐式猜测，检查优于默认信任，可重放优于不可追踪。
• 渐进增强：普通 Skill 保持简单，仅在需要时使用更强的执行和检查功能。

30 秒开始

无需克隆仓库即可安装 skills/alpha 中的生产 Skill（需要 Python 3.8+ 与网络）：

python3 -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/huangwb8/skills/main/skills/alpha/install-bensz-skills/scripts/bootstrap_install.py').read())" --source general

已克隆仓库、需要本地开发时：

python3 skills/alpha/install-bensz-skills/scripts/install.py --codex

安装器默认把 Skill 复制到 ~/.codex/skills/ 和 ~/.claude/skills/；只安装某个 Skill 可追加 --skill git-commit。skills/beta/ 仅在显式传入 --source 时处理。

这个仓库提供什么

• 可直接安装的 Skill：位于 skills/alpha/，每个目录都有面向使用者的 README.md 和面向 AI 的 SKILL.md。
• 开发流水线：覆盖初始化、Prompt 优化、文档生成、批判性测试、多代理协作、Git 发布和缺陷反馈。
• 任务执行内核：packages/bensz-skill-kernel/ 提供 bsk CLI，用来管理任务阶段、执行检查、保存证据、记录事件，并重放执行记录。
• 可审计协作：任务过程材料进入 .bensz-api/，贡献记录进入 docs/contribution.bac。

Skill 导航

当前 skills/alpha/ 包含 16 个生产 Skill：

方向	Skill
初始化与文档	init-project · write-readme
测试与协作	auto-test-code · auto-test-skill · auto-test-project · awesome-code · parallel-vibe
Prompt 与创作	better-prompt · auto-draw-plot · compact-bensz-skills
安装与版本	install-bensz-skills · git-commit · git-pr-review · git-publish-release
治理	bensz-collect-bugs · verifier-state-architect

选择 Skill 后，阅读对应目录的 README.md 获取触发方式、最小 Prompt、输入输出和 FAQ；维护者同时阅读 SKILL.md、config.yaml 与 CHANGELOG.md。

当然，我觉得最好的方式是：在你的Codex/Claude Code里把本项目的地址粘贴上，然后开始用ai来探索它！

安装方式

远程引导安装

bootstrap_install.py 只依赖 Python 标准库，最低 Python 3.8；它是仓库唯一兼容 Python 3.8、3.9 和 3.10 的首次/应急入口，该兼容范围不代表本地完整安装器或 Kernel 支持这些版本。默认远程源由 skills/alpha/install-bensz-skills/config.yaml 定义：

源	内容
general	本仓库 skills/alpha
research	huangwb8/ChineseResearchLaTeX 的科研 Skill
anthropic-docs	anthropics/skills 的文档处理 Skill

常用参数：

# 预览，不写入文件
python3 -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/huangwb8/skills/main/skills/alpha/install-bensz-skills/scripts/bootstrap_install.py').read())" --check