spec-discovery
探索與追蹤規格需求
在大型程式碼庫中尋找和追蹤需求既耗時又容易出錯。此技能可自動定位規格檔案、提取如 REQ-NOTIFY-001 等需求 ID，並生成包含內容雜湊值的可追溯清單，供下游驗證使用。
下载技能 ZIP
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
开启并开始使用
测试它
正在使用“spec-discovery”。 尋找此儲存庫中的所有需求
预期结果:
- 在 3 個規格檔案中找到 12 個需求 ID
- REPO: ai-dev-kit | 規格總數: 8
- REPO: external-libs | 規格總數: 4
- ✓ REQ-NOTIFY-001: Email Sending Endpoint (specs/external-requests/notify.md)
- ✓ REQ-NOTIFY-002: SMS Alert Configuration (specs/external-requests/notify.md)
- ✓ REQ-DATA-001: Database Schema Definition (specs/data-models.md)
- 備註：未偵測到跨儲存庫的重複 ID
正在使用“spec-discovery”。 檢查跨儲存庫的重複需求 ID
预期结果:
- 跨儲存庫掃描完成
- REPO: frontend | 找到 15 個規格
- REPO: backend | 找到 12 個規格
- REPO: shared-libs | 找到 8 個規格
- ⚠ 警告：偵測到重複 ID
- REQ-AUTH-001 同時存在於 frontend (auth/spec.md) 和 backend (api/auth.md)
- 需要採取行動：在合併規格之前解決 ID 衝突
正在使用“spec-discovery”。 驗證規格完整性
预期结果:
- 完整性檢查結果
- 基準線：2024-12-01 清單
- 目前掃描：2024-12-15
- 所有 35 個規格已驗證
- SHA-256 雜湊值與基準線相符
- 未偵測到未經授權的變更
- 結果：通過
安全审计
安全Pure prompt-based skill with no executable code. Provides workflow instructions for AI agents to parse specification files and extract traceability metadata. Static findings are false positives: 'Weak cryptographic algorithm' triggers are misunderstandings of 'hash' as file content hashes (SHA-256 is used for integrity verification, not weak crypto), and 'backtick execution' triggers are markdown formatting backticks, not shell commands. No actual network calls, scripts, or dangerous operations.
风险因素
🌐 网络访问 (1)
📁 文件系统访问 (1)
质量评分
你能构建什么
追蹤需求到實作
將需求 ID 對應到原始碼檔案，並追蹤跨儲存庫的變更以進行合規稽核。
驗證規格覆蓋率
驗證所有已陳述的需求都有對應的測試案例和實作參考。
生成文件清單
建立機器可讀的規格清冊，供下游 CI/CD 驗證管線使用。
试试这些提示
Use spec-discovery to find all requirement IDs in this repository. Return the manifest showing each spec ID, title, source path, and content hash.
Use spec-discovery with EXTRA_REPOS pointing to other project repositories. Generate a combined manifest and flag any duplicate requirement IDs.
Use spec-discovery to scan specs/external-requests/ directory. Extract all external API requirement IDs and generate traceable links to the source markdown files.
Run spec-discovery to generate a manifest. Then compare current content hashes against a baseline to detect unauthorized specification changes.
最佳实践
- 在處理多儲存庫專案時設定 EXTRA_REPOS 以擷取所有規格
- 將生成的清單與建置產出物一起儲存，以維持稽核軌跡的一致性
- 在合併來自不同團隊的規格之前，審查重複 ID 警告
避免
- 在具有巢狀專案結構的 monorepo 中執行 spec-discovery 時未指定 ROOT
- 忽略重複 ID 警告，這可能導致需求追蹤的下游混亂
- 使用 spec-discovery 來修改規格，而非僅讀取和編目它們