requirements-synclisted

# Requirements Sync Skill > **版本**: 1.1.0 | **层级**: Layer 2 (Business Skill) | **分类**: Requirements Skills ## 快速开始 ### 我应该使用这个 Skill 吗？ **使用场景**: - Story 状态变更后更新 UPM - 检查 UPM 记录是否与实际文件一致 - 批量同步需求状态 - 迭代规划时更新进度 **不使用场景**: - 验证文档格式 → 使用 `requirements-validator` - 同步到 Forgejo → 使用 `forgejo-sync` - 整体项目状态 → 使用 `state-scanner` --- ## 核心功能 | 功能 | 描述 | |------|------| | **scan-stories** | 扫描 Story 文件，提取状态 | | **update-upm** | 更新 UPM requirements 节 | | **detect-drift** | 检测 UPM 与实际的偏差 | --- ## 执行流程 ### 阶段 1: Story 扫描 ```yaml 扫描路径: pattern: "{module}/docs/requirements/user-stories/US-*.md" 提取字段: - Story ID - Status (draft/ready/in_progress/done/blocked) - Priority - Forgejo Issue (如有) 输出: scanned_stories: N status_distribution: draft: N ready: N in_progress: N done: N blocked: N ``` ### 阶段 2: PRD 扫描 ```yaml 扫描路径: pattern: "{module}/docs/requirements/prd-*.md" 提取字段: - PRD ID (从文件名) - Status (从 header) - Path 输出: current_prd: id: "prd-v2.1.0-xxx" status: approved path: "docs/requirements/prd-v2.1.0-xxx.md" ``` ### 阶段 2.5: System Architecture 扫描 ```yaml 扫描路径: primary: "docs/architecture/system-architecture.md" fallback: "{module}/docs/ARCHITECTURE.md" 提取字段: - Exists (文件是否存在) - Status (从 header 提取: draft | active | outdated) - Last Updated (从 header) - Parent PRD (从文档引用提取) 输出: system_architecture: exists: tr