Agent skill

bdd-scenario-quality-check

检查Given-When-Then格式规范性,发现场景缺口,提供丰富建议。当BDD场景编写完成后使用,确保场景质量符合CRAFT标准。

Stars 5
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/tikazyq/agentic-spec-forge/tree/main/AGENTIC_SPEC_FORGE/spec_stage_skill/implementation_planning/bdd-scenario-quality-check

SKILL.md

bdd-scenario-quality-check: BDD场景质量检查

描述

检查Given-When-Then格式规范性,发现BDD场景缺口,提供丰富建议。确保所有SC都符合CRAFT标准的Given-When-Then格式。

适用场景

  • WORKFLOW_STEP_5 Task S5-2: SC创建完成后
  • WORKFLOW_STEP_5 Task S5-3: Self-Reflection报告场景质量时
  • WORKFLOW_STEP_5 Task S5-5: CONSTRAINT验收前的质量检查

输入

  • scenarios/bdd_test_scenarios.md(所有SC)
  • goal_breakdown.md(GOAL清单)
  • 当前级别(L1/L2/L3)

输出

  • BDD场景质量报告(markdown)
  • 格式规范性得分(如"92%,23/25个场景格式正确")
  • 缺陷清单(格式错误、不完整、业务语言不清等)
  • 场景缺口清单(哪些GOAL缺少对应SC)
  • 丰富建议(如何改进场景描述)

执行策略

  1. 扫描 bdd_test_scenarios.md 提取所有SC
  2. 验证每个SC是否包含Given-When-Then三要素
  3. 检查Given/When/Then是否遵循业务语言(不含代码)
  4. 验证SC粒度(L1不超过3步,L2不超5步,L3更灵活)
  5. 检查Given-When-Then链条逻辑是否通畅
  6. 对照GOAL清单,发现缺失的SC
  7. 生成质量报告和丰富建议

价值

  • SPEC组织: 提早发现场景格式/内容问题,避免验收反复
  • QA: 清晰的测试场景描述,易于转换为自动化
  • Dev: 理解测试意图,TDD实施更精准

验收标准

  • Given/When/Then 三要素完整
  • 业务语言清晰(无代码)
  • 场景粒度适当
  • 逻辑链条通畅
  • 每个GOAL都有对应SC

Expand your agent's capabilities with these related and highly-rated skills.

tikazyq/agentic-spec-forge

code-review

执行代码审查流程(提交PR→自查→同行审查→反馈修改→合并),覆盖功能正确性、代码质量、测试完整性、安全合规四大维度。当提交Pull Request、进行结对编程、执行代码走查、需要知识共享时使用。支持L1/L2/L3三级审查深度。

5 1
Explore
tikazyq/agentic-spec-forge

code-quality

执行代码质量门禁检查(测试通过→覆盖率→Lint→GOAL追溯→可提交),验证单元测试覆盖率≥80%、集成测试通过率≥95%、代码规范零错误。当完成代码实现、准备提交代码、需要质量验证、进行提交前自检时使用。确保代码可合并。

5 1
Explore
tikazyq/agentic-spec-forge

tdd-cycle

执行 TDD 红绿重构循环(RED→GREEN→REFACTOR→REPEAT),通过先写失败测试、最小代码实现、保持绿色重构的节奏驱动开发。当启动功能开发、需要测试驱动节奏、进行迭代编码、追求高测试覆盖率时使用。提供检查清单和节奏控制。

5 1
Explore
tikazyq/agentic-spec-forge

refactoring

执行代码重构(识别坏味道→选择手法→小步修改→运行测试),在保持外部行为不变前提下改进内部结构。当TDD进入REFACTOR阶段、发现代码坏味道、需要消除重复代码、优化代码结构时使用。支持提取方法、类、参数对象等重构手法。

5 1
Explore
tikazyq/agentic-spec-forge

arch-options-compare

比较多个架构方案(单体/微服务等),从SOLID原则、成本、复杂度等维度评分,生成对比表和推荐方案。当需要向客户解释架构选择或ADR决策时使用。

5 1
Explore
tikazyq/agentic-spec-forge

dev-tech-view-supplement

根据设计补充Dev视角的技术细节(数据库/API/通信协议),帮助Dev快速进入实施。当L1/L2设计缺乏技术细节、或准备向Dev交付前使用。

5 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results