Skip to content

分析与估算工具(流程 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

向系统教授新模式 — 架构约定、估算启发式、技术栈决策或质量规则。

模式类型: architectureconventionestimationstackquality

适用场景: 当你的团队建立了 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 构建一个实时协作编辑器吗?"