用途:对头脑风暴、计划、规格等文档做结构化审查,提升清晰度、完整性与准确性,并核对文档中关于现有系统的声明是否与代码一致。
主要能力:评估文档的清晰度、完整性、具体性、YAGNI 与准确性;识别不清晰、不必要内容、被回避的决策、未言明的假设、范围膨胀风险、技术可行性及安全影响;按内容信号激活产品、设计、安全、范围守护者、对抗性等审查视角;找出一个“必须解决”的关键改进项。
使用方式:提供文档路径即读取并进入评估;未指定时询问要审查的文档,或查找 docs/brainstorms/、docs/plans/ 下最近的文档。审查中可把每个可核对声明追踪到其来源(只读)。在 Claude Code 中用 AskUserQuestion、在 Codex 中用 request_user_input,或聊天中给出编号选项来征询批准。仅在被授权时才内联修改文档;审查类请求只报告发现与建议。修改限于目标段落,不整体重写;缺少的章节只提示不代补;不生成单独审查文件。
限制:长文档采用抽样并说明覆盖范围,覆盖范围之外的声明属未验证而非通过。工作流内(如 /ia-brainstorm 或 /ia-plan 之后)还检查用户意图一致性。审查迭代最多推荐 2 轮后视情况收敛,用户坚持时最多 4 轮,之后停止并交接未解决问题与未验证声明。此前已回答或已决策的问题不重复提出,因待修复而暂撤的发现若下轮重现需重新提出。