关于 vibeguard
vibeguard 是供 Spellbook 日常使用的轻量级工作规范技能,面向需要明确任务范围、评审优先级和复盘失误的开发者。它通过清单、评分矩阵和回顾模板组织流程,不会自动运行防护脚本或修改全局配置。
主要功能
- 01编码前任务契约清单
- 02基于证据为评审发现评分
- 03按文件数量选择交付计划
- 04回归与防护复盘模板
适用场景
- 01开始编码前明确目标与验收标准
- 02对评审问题按影响和风险排序
- 03回归后查找失效的防护环节
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ majiayu000/ spellbook --skill vibeguard安装后在 Claude Code 中输入/vibeguard确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/review-template.mdscoring-matrix.mdtask-contract.yaml详细介绍
VibeGuard
适用于 Spellbook 日常使用的轻量级 VibeGuard。
此技能可帮助应对 AI 辅助工作中通常容易偏离方向的三个时刻:
- 开始实现之前
- 优先处理评审发现的问题时
- 回归或本可避免的错误发生之后
此技能包含的内容
- 一份任务契约检查清单,用于编码前界定工作范围
- 一份评分矩阵,用于根据证据确定问题的优先级
- 一份每周评审模板,用于回顾回归问题和防护措施
严格边界
此技能刻意保持轻量。
它可以:
- 指导任务启动
- 梳理评审输出
- 明确风险权衡
它不会:
- 安装钩子
- 自动运行防护脚本
- 修改全局 Claude 或 Codex 配置
- 声称已启用完整的 VibeGuard 强制执行机制
如果用户要求自动拦截、仓库级规则或环境设置,请转至完整的 VibeGuard 仓库和工具。
何时使用
用户提出以下需求时,触发此技能:
- 防幻觉防护措施
- 任务启动检查
- 评审评分或分流
- 回归预防
- 回顾模板
- 点名要求“vibeguard”
工作流
1. 从任务契约开始
打开 references/task-contract.yaml,并确认:
- 目标
- 事实来源
- 验收标准
- 范围
在这些内容明确之前,不要开始实现。
2. 采取行动前为发现的问题评分
打开 references/scoring-matrix.md,并为每项发现的问题评估:
- 影响
- 工作量
- 风险
- 置信度
利用评分区分紧急修复和依据不足的猜测。
3. 选择合适的交付方式
- 1-2 个文件:契约明确后直接实现
- 3-5 个文件:先编写简短的规格说明或步骤计划
- 6 个或更多文件:制定完整的设计/规格说明和分阶段执行计划
4. 评审故障,而不只是症状
如果出现回归,请找出哪项防御措施失效:
- 范围控制
- 事实来源验证
- 验证深度
- 评审优先级排序
- 缺少防护措施
然后在 references/review-template.md 中记录后续事项。
预期输出
根据请求,生成以下内容之一:
- 填写完毕的任务契约
- 带优先级的评分问题表
- 简短的回归评审或每周回顾
参考文件
references/task-contract.yaml- 任务启动检查清单references/scoring-matrix.md- 优先级排序模型references/review-template.md- 回顾模板
评论
支持 Markdown