Agent-Skills.md

Agent Skills: goal-traceability-validator

验证GOAL的source_vs追溯链完整性，确保每个GOAL都能追溯到原始VS。当GOAL创建完成后使用。

UncategorizedID: tikazyq/agentic-spec-forge/goal-traceability-validator
51

Install this agent skill to your local

pnpm dlx add-skill https://github.com/tikazyq/agentic-spec-forge/tree/HEAD/AGENTIC_SPEC_FORGE/spec_stage_skill/implementation_planning/goal-traceability-validator

Skill Files

Browse the full folder contents for goal-traceability-validator.

Download Skill

Loading file tree…

AGENTIC_SPEC_FORGE/spec_stage_skill/implementation_planning/goal-traceability-validator/SKILL.md

Skill Metadata

Name
goal-traceability-validator
Description
验证GOAL的source_vs追溯链完整性，确保每个GOAL都能追溯到原始VS。当GOAL创建完成后使用。

goal-traceability-validator: GOAL追溯性验证

描述

验证goal_breakdown.md中每个GOAL都有正确的source_vs字段，指向现存的VS。避免追溯链断裂导致需求遗漏。

适用场景

  • WORKFLOW_STEP_5 Task S5-2: GOAL创建完成后立即检查
  • WORKFLOW_STEP_5 Task S5-3: Self-Reflection报告追溯链一致性
  • WORKFLOW_STEP_5 Task S5-5: CONSTRAINT验收前的链接检查

输入

  • design/（所有VS及其ID）
  • implementation/goal_breakdown.md（所有GOAL）

输出

  • 追溯链验证报告（markdown）
  • 追溯链完整性百分比（如"100%, 所有GOAL都有source_vs"）
  • 问题清单：
    • 缺失source_vs的GOAL
    • 指向不存在VS的GOAL
    • 指向不正确VS的GOAL
  • 修复建议

执行策略

  1. 从design/提取所有VS及其ID（格式：VS-<SN>-NNN）
  2. 从goal_breakdown.md读取所有GOAL，检查source_vs字段
  3. 验证source_vs格式正确（VS-<SN>-NNN）
  4. 验证source_vs引用的VS确实存在
  5. 生成验证报告和问题清单
  6. 建议修复方案（指向正确的VS）

价值

  • SPEC组织: 防止追溯链断裂，确保需求完整性
  • PM/BA: 验证GOAL与需求映射的准确性
  • Dev: 清晰的需求链接，避免理解偏差

验收标准

  • 所有GOAL都有source_vs字段
  • 所有source_vs引用有效的VS
  • 追溯链逻辑合理（VS对应GOAL，GOAL对应SC）