Claude Skills by huangwb8

Use when you have a spec or requirements for a multi-step task, before touching code

当 Bensz 系列 skills 在真实用户环境中因 skill 设计缺陷而出现 bug，或用户明确说“我想 report bensz skills bugs”“帮我公开上报 bensz skills 的 bug”时使用。该 skill 负责把 bug 规范化记录到 `~/.bensz-skills/bugs/`，并在用户明确要求公开报告时通过本地 `gh` 轻量上传到 `huangwb8/bensz-bugs`，全程严禁修改用户本地 Claude Code/Codex 中已安装 skills 的源代码。

当用户明确要求"优化 prompt"、"改进提示词"、"润色指令"或"将简陋 prompt 转换为最佳实践版本"时使用。基于 OpenAI 和 Anthropic 官方最佳实践，对用户提供的简陋 prompt 进行结构化优化，输出符合社区标准的高质量版本。

当用户明确要求“压缩/瘦身/精简某个 Agent Skill 的 Markdown 文档”“在不改变功能前提下降低 skill 上下文开销”时使用。先理解目标 skill 的真实能力与安全边界，再在忽略 `tests/`、`plans/` 以及目标 skill 的 `README.md`、`CHANGELOG.md` 的前提下，压缩 `SKILL.md`、`references/*.md` 等工作型 Markdown，并把中间产物隔离到 `.compact-bensz-skills/`。⚠️ 不适用：用户主要想新增功能、修复脚本逻辑、批量改代码、或只想压缩非 skill 文档。

当用户明确要求“review 某个 GitHub PR”“评估某个 pull request 是否值得 merge”“帮我判断这个 PR 怎么处理”时使用。基于用户提供的 GitHub 仓库地址、PR 编号/链接和补充说明，进行只读、证据驱动的 PR 审查：理解 PR 解决的问题、评估方案优劣与局限、默认优先使用内置“好 PR”标准并在必要时联网补充、识别恶意或高风险改动，并输出是否建议 merge 的 Markdown 决策报告。⚠️ 不适用：用户要你直接修改 PR 代码、直接 merge PR、或在本地执行 PR 分支中的不可信代码。

当用户明确要求"并行执行同一条 Vibe Coding 指令 / 多线程并行尝试多种方案 / 在多个独立工作区里同时推进"时使用。在用户当前工作目录创建 `.parallel_vibe/`，复制出多个独立工作区并按计划运行每个 thread 的 runner（默认串行、可选并行），最后在 `@main/summary.md` 汇总结果。⚠️ 不适用：用户只是想并行跑 shell 命令/单元测试/下载任务（应直接用并发工具或 CI）、没有明确"多工作区并行尝试/多方案对比"意图、要求强安全隔离或处理高度敏感数据（应使用容器/沙箱方案）。

当用户明确要求"测试项目"、"运行 auto-test-project"或"进行项目级测试"时使用。 对完整项目（如 skill、workflow、或类似 init-project 定义的流程项目）进行多轮 A 轮批判性测试 + B 轮质量检查，系统化发现、记录、修复问题。 **核心能力**: - 支持多轮 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` 为准 - 规范化测试会话命名：`vYYYYMMDDH...

当用户明确要求"测试技能"、"运行 auto-test"或"进行批判性测试"时使用。 通过多轮 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 项） - 规范化测试会话命名：`vYYYY...

当用户明确要求"提交 Git 改动"、"生成 commit 信息"或"创建 git commit"时使用。仅用 Git 分析改动并自动生成 conventional commit 信息（可选 emoji）；必要时建议拆分提交，默认运行本地 Git 钩子（可 --no-verify 跳过）。

当用户明确要求"发布项目到 GitHub"、"创建 GitHub Release"或"生成 Release Notes"时使用。智能分析 tag 间历史变化，生成专业且吸引人的 Release Notes，自动创建 GitHub Release。支持首次发布、常规版本、预发布版本（alpha/beta/rc），自动识别 prerelease 标记。

当用户明确要求"初始化项目"、"创建项目指令文件"或"生成 AGENTS.md"时使用。完全自动化：自动检测操作系统默认语言，分析项目目录结构（支持 Python/Web/Rust/Go/Java/数据科学/文档项目等），推断项目类型和用途，一键生成规范的项目指令文档。生成文件包括：AGENTS.md（跨平台通用项目指令，Single Source of Truth）、CLAUDE.md（Claude Code 特定适配，通过 @./AGENTS.md 引用）、README.md（项目介绍与使用方法）、CHANGELOG.md（项目变更记录）。

当需要把本仓库 pipelines/skills 下的所有 skills 安装到系统级（默认同时安装到 Codex: ~/.codex/skills 和 Claude Code: ~/.claude/skills），以便在任意项目/对话中可被发现与调用时使用。使用 MD5 哈希进行版本控制，仅安装有更新的 skills；支持强制覆盖安装和指定单一目标安装。支持远程安装模式（--remote --check/--auto），从 GitHub 仓库下载并安装技能。

当用户明确要求"生成技能 README"、"编写用户指南"或"更新技能文档"时使用。为 Agent Skills 编写符合最佳实践的 README.md 用户使用指南。自动分析技能结构（SKILL.md、config.yaml、scripts/），按模板生成小白友好的文档。