analyze

name	analyze
description	当用户要做一致性检查、交叉比对，或 tasks 拆完后 implement 之前使用。把 spec/plan/tasks 放一块找打架和遗漏。关键词：一致性、交叉比对、检查、analyze、对不上、冲突。

analyze — 一致性检查（对得上吗）

触发词

一致性、交叉比对、检查、analyze、对不上、冲突、矛盾、查漏、交叉检查

概述

把 spec.md、plan.md、tasks.md 放一块交叉比对，找出互相打架、对不上、遗漏的地方。在正式写代码之前跑，把"没想清楚""对不上"的坑提前填了。

SDD 的兜底环节。不是必跑，但正经活建议跑一遍。

何时该用

• tasks.md 刚拆完，写代码前
• 三份文档任一份改动后，重新对齐
• 用户怀疑"哪里对不上"

前置条件

• .agents/specs/{feature}/ 下至少有 spec.md 和 plan.md，最好也有 tasks.md

工作流

1. 读三份文档

完整读 spec.md、plan.md、tasks.md。

2. 交叉比对

按以下维度逐一检查：

spec → plan（需求有没有技术方案支撑）

• spec 的每个功能，plan 有对应的模块/接口吗？
• spec 的非功能需求（性能/兼容/安全），plan 有对策吗？
• spec 的"明确不做"，plan 有没有偷偷设计了？

plan → tasks（方案有没有任务覆盖）

• plan 的每个模块，tasks 有对应的实现任务吗？
• plan 的每个接口，tasks 有"写这个接口"的任务吗？
• plan 的数据模型，tasks 有"建表/迁移"任务吗？

tasks → spec（任务有没有覆盖需求）

• tasks 全做完，spec 的所有功能 DoD 都能满足吗？
• 有没有 spec 要的功能，tasks 里一条都没有？

互相矛盾

• spec 说"实时更新"，plan 没提实时机制？
• plan 说"用 SQLite"，tasks 却有"配置 Redis 连接"？
• tasks 有任务依赖了不存在的文件/模块？

3. 产出检查报告

在 .agents/specs/{feature}/analysis.md 写入：

# 一致性检查报告

## 严重问题（必须修）
- [矛盾/遗漏] {描述} → 建议改 {哪个文档的哪部分}

## 次要问题（建议修）
- ...

## 通过项
- spec 的 N 个功能均有 plan 支撑
- plan 的 N 个模块均有 tasks 覆盖

4. 报告给用户，修复后进 implement

把问题列给用户，逐条确认怎么改。改完后：

一致性已对齐。下一步进入 implement 照 tasks.md 实现。要开始吗？

若无问题：

一致性检查通过，无冲突遗漏。可以进入 implement。要开始吗？

坑点清单（Gotchas）

• 只读不比对：三份都读了但没交叉对照 = 白跑。每条检查都要跨文档追。
• 漏查非功能需求：只查功能，漏了 spec 里的性能/安全要求 plan 有没有对策。
• 不产出报告：只在对话里说"没问题"，没存 analysis.md，无法追溯。
• 发现问题不修就往下走：发现了矛盾却急着 implement，返工更大。

关键规则

• 必须逐维度交叉比对（spec↔plan↔tasks），不要只读不比。
• 必须产出 analysis.md 存档。
• 发现的严重问题必须修完才进 implement。
• 无问题时也要明确说"通过"，不要跳过。

参考

• 上游 skill：tasks（任务拆解）
• 下游 skill：implement（实现）