Agent skill

goal-granularity-check

确保GOAL粒度合理，不过粗或过细。当GOAL创建完成后使用，确保GOAL符合单一职责原则。

View SKILL.md on GitHub Repository
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/goal-granularity-check

SKILL.md

goal-granularity-check: GOAL粒度检查

描述

检查goal_breakdown.md中所有GOAL的粒度（granularity），确保GOAL不过粗（能分解）也不过细（无意义）。

适用场景

  • WORKFLOW_STEP_5 Task S5-2: GOAL创建初期，验证粒度合理性
  • WORKFLOW_STEP_5 Task S5-3: Self-Reflection中定期审视GOAL颗粒度
  • CONSTRAINT验收前: 检查GOAL粒度是否符合CRAFT标准

输入

  • goal_breakdown.md（所有GOAL）
  • scenarios/bdd_test_scenarios.md（对应的SC）
  • design/architecture.md（模块划分）
  • 当前级别（L1/L2/L3）

输出

  • GOAL粒度分析报告（markdown）
  • 粗粒度问题清单（可进一步分解的GOAL）
  • 细粒度问题清单（无实质意义的GOAL）
  • 粒度评分（% 合理）
  • 重构建议

执行策略

  1. 读取goal_breakdown.md中所有GOAL
  2. 对每个GOAL，检查以下指标：
    • 可分解性: 是否可进一步分解成多个独立GOAL？
      • 可分解 → 过粗（标记为问题）
    • 有界性: GOAL范围是否清晰？
      • 模糊 → 可能过粗
    • SC数量: 对应多少个SC？
      • 过多(>5) → 可能过粗
      • 过少(<1) → 可能过细或无用
    • 复杂度: 估算实现难度
      • 很高 → 可能过粗
  3. 对粗粒度GOAL提出分解建议
  4. 对细粒度GOAL提出合并建议
  5. 生成重构方案

价值

  • Dev: 合理的GOAL粒度，便于TDD实施
  • QA: 清晰的GOAL范围，便于SC编写
  • Architecture: GOAL与模块对应关系清晰

验收标准（CRAFT标准）

级别 过粗标准 过细标准 最佳粒度
L1 可分解3个+ SC<1个 2-3个SC
L2 可分解2个+ SC<1个 3-5个SC
L3 可分解2个+ SC<1个 3-5个SC

Recommended Agent Skills

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