Agent Skills
返回列表
🤖

技能构建向导

AI Agent 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_2a52e6b3/skill-build-wizard。

技能介绍

为什么需要构建向导？

在构建 Agent Skills 时，开发者常面临需求不清导致返工、代码逻辑遗漏边界处理、以及发布前缺乏标准化验收等问题。本技能作为一套端到端的构建工作流，专为人类用户设计，通过结构化的检查清单和明确的阶段划分，规避开发过程中的常见坑点。

核心工作流

技能将构建过程拆解为四个必须按序执行的阶段，每个阶段交接处均需用户明确确认：

  • 阶段一：预检检查。通过 scripts/pre-check.sh 自动化检查工作区 Git 状态，并给出长任务超时与跨会话上下文恢复的建议，该阶段可随时跳过。
  • 阶段二：规格澄清。强制调用 skill-creator 进行脚手架构建，要求在编码前输出完整设计并等待确认，严格禁止依赖本地硬编码路径。
  • 阶段三：编码验收。执行四项严格检查：设计一致性、边界用例、两轮代码与文档审查（含 set -e 等稳定性检查）、以及两轮冒烟测试，确保不带病进入发布阶段。
  • 阶段四：发布准备。依次运行 skill-regression、glic-check、skill-release-audit 等质量门禁，并在执行 skill-release-plus 发布前，强制要求用户确认版本号与 Changelog。

适用边界与注意点

本向导依赖于 build-better-skills 套件及上游 Anthropic 的 skill-creator 等特定技能。它并非自动化的黑盒工具，而是引导式工作流，高度依赖开发者在关键节点的主动介入与确认。此外，跨环境验证步骤无法自动化，必须在真实的独立机器上手动完成测试，以确保产物的通用性与安全性。

使用场景

  • 梳理需求时，需按阶段确认设计并调用 skill-creator 搭建脚手架，避免直接编码导致返工。
  • 编写脚本后，需执行检查清单中的边界用例测试与两轮代码审查，确保不带病进入发布。
  • 打包发布前，需运行 glic-check 等质量门禁，并在上传前向用户明确确认版本号与变更日志。
  • 开发初期，通过 pre-check.sh 检查 Git 状态与长任务超时风险，提前规避环境导致的构建中断。

适合人员

  • Agent 技能开发者，诉求是获得标准化的构建流程，避免因遗漏检查项导致线上故障。
  • 开源项目维护者，诉求是规范社区贡献的技能代码，确保提交的产物符合质量与安全基线。
  • 企业内部工具开发者，诉求是建立可复用的技能发布流水线，统一团队内部的开发规范。
  • Agent 工作流架构师，诉求是沉淀可落地的验收标准，将技能构建质量管控前置到开发阶段。