分析与估算工具（流程 C）
流程 C 工具帮助你理解代码库、估算工作量、检测质量问题，以及保持规格与实际情况对齐。
快速参考
| 工具 | 描述 | 可用性 |
|---|---|---|
estimate | 计算构建某功能的时间、工作量和成本 | 已包含 |
estimate_ai_cost | 估算实现规格的 AI 词元成本 | 已包含 |
validate | 检查计划实际构建了多少 | 已包含 |
detect_drift | 检测实现偏离已批准规格的位置 | 已包含 |
validate_workflow | 验证开发工作流是否与预期流程匹配 | 已包含 |
audit | 全面审计项目配置、架构和合规性 | 已包含 |
audit_stack | 分析技术栈的兼容性、安全性和性能问题 | 已包含 |
audit_trail | 查询不可变审计日志 | 已包含 |
generate_attestation | 为规格生成合规认证文档 | 已包含 |
reverse_engineer | 从现有代码逆向工程规格 | 已包含 |
scan_project | 扫描整个项目并并行分析模块 | 已包含 |
learn_pattern | 从代码库中捕获已学习的模式或最佳实践 | 已包含 |
capture_learning | 从实现经验中捕获模式 | 已包含 |
paradigm_report | 报告项目中的架构范式和模式 | 已包含 |
reality_check | 根据真实世界的约束和假设验证计划 | 已包含 |
security_check | 对代码库和规格运行全面安全分析 | 已包含 |
security_report | 从审计日志生成安全报告 | 已包含 |
living_spec_watch | 监视规格变更并自动与代码同步 | 已包含 |
living_spec_status | 获取活态规格同步状态 | 已包含 |
living_spec_coverage | 显示活态规格的测试覆盖率分析 | 已包含 |
sync_spec_to_code | 将规格验收标准同步到代码注释和测试 | 已包含 |
sync_code_to_spec | 将代码变更同步回规格作为活态文档 | 已包含 |
resolve_sync_conflict | 解决同步期间规格和代码之间的冲突 | 已包含 |
snapshot_spec_hashes | 创建规格内容哈希快照以进行变更跟踪 | 已包含 |
auto_reconcile | 使用模式匹配自动将规格与代码变更协调 | 已包含 |
validate_annotations | 验证规格中注释的正确性和完整性 | 已包含 |
generate_annotations | 根据最佳实践为规格生成注释 | 已包含 |
估算
estimate
根据计划计算构建某功能的时间、工作量和成本。
输出内容：
- 故事点范围（乐观 / 现实 / 悲观）
- 美元成本范围（基于
SDD_HOURLY_RATE） - AI 辅助实现的词元用量估算
- 影响估算的风险因素
- 按实现阶段细分
适用场景： 在将规格提交到冲刺之前，或向利益相关者说明范围时。
提示词："Estimate spec SPEC-003 for project proj_abc123"
提示词："How much effort is spec SPEC-007 in project proj_abc123?"estimate_ai_cost
估算实现规格的 AI 词元成本 — 按模型、阶段和复杂度细分。
输出内容：
- 每个实现阶段的词元计数估算
- 按模型的成本明细（GPT-4、Claude 等）
- 复杂度乘数和风险因素
- 不同 AI 模型之间的比较
适用场景： 在为 AI 辅助开发制定预算时，或在选择用于实现的模型时。
提示词："Estimate AI cost for spec SPEC-003 in project proj_abc123"验证
validate
检查计划实际构建了多少。将规格验收标准与真实代码进行比较。
检查内容：
- 哪些验收标准被代码满足
- 哪些缺失或只是部分实现
- 整体覆盖率百分比
- 弥补缺口的建议
适用场景： 完成实现后，在将规格标记为 done 之前。
提示词："Validate spec SPEC-001 against the code at /workspace/my-app/src for project proj_abc123"detect_drift
分析代码变更是否偏离已批准的规格，并高亮显示实现偏差位置。
报告内容：
- 不再与代码匹配的标准
- 任何规格都未覆盖的新代码模式
- 自上次检查以来引入的章程违规
- 受漂移影响的下游规格（级联影响）
适用场景： 随着代码库的演进定期执行，或在任何重大发布之前。
提示词："Detect drift in spec SPEC-003 for project proj_abc123"
提示词："Check if my implementation matches the SPEC-001 spec"validate_workflow
验证开发工作流是否与预期流程匹配 — 检查规格状态转换、审查门和团队实践是否遵循配置的工作流。
适用场景： 在新团队入职使用 Planu 时，或在流程变更后验证采用情况时。
提示词："Validate the development workflow for project proj_abc123"审计
audit
全面审计项目配置、架构和合规性。生成 0–100 的质量评分。
评分细分：
- SOLID 原则合规性
- 清洁代码指标（命名、函数大小、耦合度）
- 架构层合规性
- 章程遵守
- 测试覆盖率信号
适用场景： 在代码审查期间、合并之前，或作为定期代码库健康检查。
提示词："Audit the code at /workspace/my-app/src for project proj_abc123"audit_stack
分析当前技术栈的兼容性、安全性和性能问题。
检查内容：
- 依赖版本兼容性
- 已知 CVE 和安全公告
- 所选技术栈中的性能反模式
- 升级或替换建议
适用场景： 在季度审查期间或重大发布之前，捕获依赖树中的隐藏风险。
提示词："Audit the tech stack for project proj_abc123"audit_trail
查询不可变审计日志。按 specId、userId、eventType 和日期范围筛选。
返回内容：
- 所有规格变更和状态转换的时间顺序日志
- 谁触发了每个事件以及何时触发
- 产生变更的工具调用
- 可导出用于合规目的
适用场景： 在安全审计、合规审查或调查规格回归时。
提示词："Show the audit trail for spec SPEC-005 in project proj_abc123"
提示词："List all events by user alice in project proj_abc123 this month"generate_attestation
为特定规格生成合规认证文档 — 确认所有验收标准均已满足、审查和验证。
输出内容：
- 带规格 ID 和标准摘要的签名认证
- 验证运行的时间戳
- 覆盖率百分比和任何未解决的例外情况
- 可纳入合规包
适用场景： 当规格必须在发布前通过正式合规审查时（SOC 2、HIPAA、ISO 27001 等）。
提示词："Generate an attestation for spec SPEC-010 in project proj_abc123"逆向工程与扫描
reverse_engineer
从现有代码逆向工程规格。
适用场景： 当你有可运行的代码但没有规格时 — 在接手遗留系统时很常见，或当一个功能是临时构建的，现在需要正式记录时。
输出内容： 从代码逆向工程出的完整 spec.md — 从实现行为推断验收标准，从数据模型推断架构，并识别行为模糊的缺口。
提示词："Reverse engineer my codebase at /workspace/my-app/src/auth and generate specs for project proj_abc123"scan_project
扫描整个项目，发现模块，并行分析每个模块，检测跨模块依赖和反模式。
输出内容：
- 带依赖图的模块映射
- 横切关注点和耦合问题
- 反模式检测（上帝对象、循环依赖、抽象泄漏）
- 每个模块的规格覆盖率差距
适用场景： 在入职到大型陌生代码库时，或在重大重构之前。
TIP
scan_project 是理解现有代码库最快的方式。在遗留项目上创建任何规格之前先运行它。
提示词："Scan the project at /workspace/my-app for proj_abc123"学习
learn_pattern
从代码库中捕获已学习的模式或最佳实践，以便在未来规格中复用。
模式类型： architecture（架构）、convention（约定）、estimation（估算）、stack（技术栈）、quality（质量）
适用场景： 当你的团队建立了 Planu 在生成规格、计划或估算时应应用的模式时。
提示词："Teach planu that we always use repository pattern for database access in project proj_abc123"
提示词："Add an estimation pattern: API integrations always take 2x longer than expected for project proj_abc123"capture_learning
从实现经验中捕获已学习的模式或改进机会 — 具有语义去重功能。
适用场景： 在 bug 事后复盘、痛苦的估算错误，或任何你希望应用于未来规格的工作流发现之后。
Planu 会与现有模式去重，这样你就不会积累冗余的规则。
提示词："Capture learning: when integrating third-party OAuth, always verify token expiry handling with an explicit test"paradigm_report
生成项目中架构范式和模式的报告 — 函数式、OOP、响应式、事件驱动、声明式等。
适用场景： 在入职到陌生代码库时，或在建立应在规格中执行的编码标准时。
提示词："Generate a paradigm report for project proj_abc123"reality_check
根据真实世界的约束和假设验证计划。
评估内容：
- 当前技术栈的技术可行性
- 依赖约束
- 基于历史估算的时间线现实性
- 可能阻碍交付的风险
适用场景： 在承诺截止日期之前，或当利益相关者提出似乎不切实际的要求时。
提示词："Reality check: can we build a real-time collaborative editor in 2 weeks for project proj_abc123?"安全
security_check
对代码库和规格运行全面安全分析 — OWASP Top 10、不安全模式，以及带漂移检测的安全评分（A–F）。
检查内容：
- 注入漏洞（SQL、命令、LDAP）
- 身份验证和会话管理
- 敏感数据暴露
- 访问控制问题
- 安全配置错误
适用场景： 在任何涉及身份验证、授权、支付或用户数据的规格之前。
提示词："Run a security check on spec SPEC-005 for project proj_abc123"
提示词："Security audit the code at /workspace/my-app/src/api for project proj_abc123"security_report
从审计日志生成安全报告 — 显示威胁、被阻止的调用和建议。
输出内容：
- 审计日志中安全事件的摘要
- 检测和阻止的威胁
- 按严重程度排序的未解决漏洞
- 修复建议
适用场景： 用于定期安全审查、合规包或安全事件后。
提示词："Generate a security report for project proj_abc123"活态规格
活态规格与你的代码自动保持同步。以下工具管理这种双向同步。
living_spec_watch
监视规格变更并在实现演进时自动与代码同步。
适用场景： 在规格的活跃实现期间，保持规格文档最新，无需手动协调。
提示词："Start watching spec SPEC-007 in project proj_abc123"living_spec_status
获取活态规格同步状态 — 显示正在被监视的规格及其最后同步时间戳。
提示词："Show living spec status for project proj_abc123"living_spec_coverage
显示活态规格的测试覆盖率分析 — 将测试文件映射到验收标准。
适用场景： 在将活态规格标记为完成之前，验证所有标准是否都有对应的测试。
提示词："Show living spec coverage for SPEC-007 in project proj_abc123"sync_spec_to_code
将规格验收标准同步到代码注释和测试 — 将标准引用作为结构化注释注入到实现文件中。
适用场景： 在实现开始时，为 AI 代理（或开发者）提供代码和标准之间的清晰链接。
提示词："Sync spec SPEC-007 criteria to the code in project proj_abc123"sync_code_to_spec
将代码变更同步回规格作为活态文档 — 更新规格以反映代码实际执行的内容。
适用场景： 在实现以应被捕获为新真相的方式偏离原始规格之后。
提示词："Sync code changes back to spec SPEC-007 in project proj_abc123"resolve_sync_conflict
解决同步期间规格和代码之间的冲突 — 呈现每个冲突供人工决策。
适用场景： 当 sync_spec_to_code 或 sync_code_to_spec 检测到需要人工判断的矛盾时。
提示词："Resolve sync conflicts for spec SPEC-007 in project proj_abc123"snapshot_spec_hashes
创建规格内容哈希快照以进行变更跟踪 — 支持随时间对规格内容进行差异比较。
适用场景： 在重大重构或发布之前建立漂移检测的基线。
提示词："Snapshot spec hashes for project proj_abc123"auto_reconcile
使用模式匹配自动将规格与代码变更协调 — 在无需人工干预的情况下应用已学习的协调规则。
适用场景： 作为 CI 步骤，在每次合并后保持规格对齐。
提示词："Auto-reconcile all specs in project proj_abc123"validate_annotations
验证规格中注释的正确性和完整性 — 检查标准引用、文件链接和元数据是否有效。
提示词："Validate annotations for spec SPEC-007 in project proj_abc123"generate_annotations
根据最佳实践为规格生成注释 — 添加结构化元数据、标准引用和可追溯链接。
提示词："Generate annotations for spec SPEC-007 in project proj_abc123"另请参阅
- 规格生命周期工具（流程 B） — 创建、更新和管理规格
- 设计与规划工具（流程 D） — 架构决策、数据库设计、执行计划
- 平台与运维工具（流程 E–I） — 技术栈、代理、Git、治理