分析与估算工具(流程 C)
流程 C 包含 10 个工具,用于理解你的代码库、估算工作量、检测质量问题,以及保持规格与实际情况对齐。
estimate
使用多代理分析估算规格的工作量、成本和 token 用量。
输出内容:
- 故事点范围(乐观 / 现实 / 悲观)
- 美元成本范围(基于
SDD_HOURLY_RATE) - AI 辅助实现的 token 用量估算
- 影响估算的风险因素
- 按实现阶段细分
适用场景: 在将规格提交到冲刺之前,或向利益相关者说明范围时。
提示词:"估算项目 proj_abc123 中的规格 SPEC-003"
提示词:"项目 proj_abc123 中规格 SPEC-007 需要多少工作量?"reverse_engineer
分析现有代码并从中生成 SDD 规格。
适用场景: 当你有可运行的代码但没有规格时 — 在接手遗留系统时很常见,或当一个功能是临时构建的,现在需要正式记录时。
输出内容: 从代码逆向工程出的完整 HU.md — 从实现行为推断验收标准,从数据模型推断架构,并识别行为模糊的缺口。
提示词:"逆向工程 /Users/me/my-app/src/auth 的代码并为项目 proj_abc123 生成规格"validate
根据规格验证实现 — 覆盖率、漂移和质量。
检查内容:
- 哪些验收标准被代码满足
- 哪些缺失或只是部分实现
- 整体覆盖率百分比
- 弥补缺口的建议
适用场景: 完成实现后,在将规格标记为 done 之前。
提示词:"根据 /Users/me/my-app/src 的代码验证项目 proj_abc123 中的规格 SPEC-001"detect_drift
检测规格与实现之间的漂移 — 包括章程合规性和下游规格影响分析。
报告内容:
- 不再与代码匹配的标准
- 任何规格都未覆盖的新代码模式
- 自上次检查以来引入的章程违规
- 受漂移影响的下游规格(级联影响)
适用场景: 随着代码库的演进定期执行,或在任何重大发布之前。
提示词:"检测项目 proj_abc123 中规格 SPEC-003 的漂移"
提示词:"检查我的实现是否符合 SPEC-001 规格"audit
审计代码的 SOLID 原则、清洁代码、架构和章程违规。生成 0–100 的质量评分。
评分细分:
- SOLID 原则合规性
- 清洁代码指标(命名、函数大小、耦合度)
- 架构层合规性
- 章程遵守
- 测试覆盖率信号
适用场景: 在代码审查期间、合并之前,或作为定期代码库健康检查。
提示词:"审计项目 proj_abc123 中 /Users/me/my-app/src 的代码"learn_pattern
向系统教授新模式 — 架构约定、估算启发式、技术栈决策或质量规则。
模式类型: architecture、convention、estimation、stack、quality
适用场景: 当你的团队建立了 SpecForge 在生成规格、计划或估算时应应用的模式时。
提示词:"教会 specforge 我们在项目 proj_abc123 中总是对数据库访问使用仓储模式"
提示词:"添加一个估算模式:API 集成总是比预期花费 2 倍时间,项目 proj_abc123"security_check
根据 OWASP Top 10 分析规格,扫描代码中不安全的模式,并生成带漂移检测的安全评分(A–F)。
检查内容:
- 注入漏洞(SQL、命令、LDAP)
- 身份验证和会话管理
- 敏感数据暴露
- 访问控制问题
- 安全配置错误
适用场景: 在任何涉及身份验证、授权、支付或用户数据的规格之前。
提示词:"对项目 proj_abc123 中的规格 SPEC-005 运行安全检查"
提示词:"对项目 proj_abc123 中 /Users/me/my-app/src/api 的代码进行安全审计"capture_learning
将发现的模式或经验教训以语义去重的方式捕获到规格系统中。
适用场景: 在 bug 事后复盘、痛苦的估算错误,或任何你希望应用于未来规格的工作流发现之后。
SpecForge 会与现有模式去重,这样你就不会积累冗余的规则。
提示词:"捕获经验教训:集成第三方 OAuth 时,始终通过明确的测试验证 token 过期处理"paradigm_report
检测并报告项目中使用的编程范式 — 函数式、OOP、响应式、事件驱动、声明式等。
适用场景: 在接手不熟悉的代码库时,或在建立应在规格中执行的编码标准时。
提示词:"为项目 proj_abc123 生成范式报告"reality_check
评估一组需求在给定项目上下文中是否可行。
评估内容:
- 当前技术栈的技术可行性
- 依赖约束
- 基于历史估算的时间线现实性
- 可能阻碍交付的风险
适用场景: 在承诺截止日期之前,或当利益相关者提出似乎不切实际的要求时。
提示词:"现实检验:我们能在 2 周内为项目 proj_abc123 构建一个实时协作编辑器吗?"