| name | speckit-analyze |
| description | 在 tasks.md 已生成后，对 spec.md、plan.md、tasks.md 三大核心工件进行“只读、无损”的跨工件一致性与质量分析，识别冲突、重复、歧义、遗漏与宪法（constitution）违反项，并输出结构化分析报告与可选修复建议。 |
Speckit_Analyze
🧠 Skill 简介
Speckit_Analyze 是一个“跨工件一致性与质量审计”的项目级 Skill。
它在 tasks.md 生成完成之后运行，通过只读方式对以下三类核心工件进行联合分析：
spec.md（需求与验收意图）plan.md（设计与技术约束）tasks.md（可执行任务分解）
目标是：在进入实现（implement）之前，系统性发现高风险不一致与覆盖缺口，避免后续返工。
🎯 适用场景（When to Use This Skill）
在以下情况下，应使用本 Skill：
- 已成功运行
speckit-tasks skill 并生成完整 tasks.md
- 准备进入实现阶段（
speckit-implement skill）前，希望进行质量门禁
- 怀疑存在以下风险：
- 需求写得很好，但任务没覆盖
- 计划与需求冲突（术语漂移、实体不一致、架构假设不一致）
- tasks 引入了 spec/plan 未定义的组件或范围漂移
- 非功能需求（安全/性能/可用性）被遗漏
- 宪法（constitution）要求未被满足
📥 输入（Input）
-
必需工件
-
强约束来源
@.claude/constitution.md（宪法）
-
用户补充输入（可选）：$ARGUMENTS
- 用于提供分析侧重点、风险偏好、或已知争议点（例如“重点查安全与性能”）
前提条件：
- 本 Skill 仅在
tasks.md 已生成后运行
- 任一必需工件缺失应终止，并提示补齐前置命令
🧭 运行约束（Operating Constraints）
只读、无损（Strictly Read-Only）
- 绝不修改任何文件
- 只输出结构化分析报告
- 可提供“可选修复计划”，但必须由用户明确确认后才可通过其他命令手工执行修复
宪法优先（Constitution Authority）
- 宪法中的 MUST 原则在分析范围内不可协商
- 任何宪法冲突自动判定为 CRITICAL
- 不允许通过“弱化解释/忽略原则”规避冲突
- 若需要修改宪法原则，必须走独立的宪法更新流程，不属于本 Skill 范畴
🧩 Skill 核心能力
1️⃣ 工件最小上下文加载（Progressive Disclosure）
为保持高信噪比与可重复性，Skill 只加载必要内容：
-
从 spec.md：
- Overview/Context
- Functional Requirements
- Non-Functional Requirements
- User Stories
- Edge Cases（若存在）
-
从 plan.md：
- 架构/技术栈选择
- 数据模型引用
- 分期（phases）
- 技术约束
-
从 tasks.md：
- Task IDs
- 任务描述与阶段分组
- 并行标记
[P]
- 文件路径引用
-
从 constitution.md：
- 原则名称
- MUST/SHOULD 的规范性约束语句
2️⃣ 语义模型构建（内部，不直接输出原文）
Skill 会构建内部语义索引，用于跨文档映射：
- 需求清单（Requirements Inventory）
- 为每条功能/非功能需求生成稳定 key（slug）
- 用户故事/动作清单（Story/Action Inventory）
- 任务覆盖映射（Task Coverage Mapping）
- 将任务映射到需求或用户故事（基于显式引用与高置信关键词推断）
- 宪法规则集（Constitution Rule Set）
3️⃣ 检测与发现（Findings Detection Passes）
本 Skill 仅聚焦高信号发现，最多输出 50 条 findings（超出部分汇总）。
A. 重复（Duplication）
- 近似重复的需求/约束
- 标注更低质量的表述，建议合并与统一表述
B. 歧义（Ambiguity）
- “fast / scalable / secure / intuitive / robust”等模糊词未量化
- 占位符与未决标记（TODO、TKTK、???、
<placeholder>）
C. 描述不足（Underspecification）
- 有动词但缺少对象/结果/衡量标准的需求
- 用户故事缺少可对齐的验收意图
- tasks 引用 spec/plan 未定义的组件、模块或范围
D. 宪法对齐（Constitution Alignment）
- 任何违反 MUST 的内容
- 宪法要求的质量门禁/章节缺失（按宪法定义）
E. 覆盖缺口（Coverage Gaps）
- 需求没有任何任务覆盖
- 任务无法映射到任何需求/用户故事（范围漂移风险）
- 非功能需求没有在 tasks 中体现（例如安全/性能/可观测性）
F. 不一致（Inconsistency）
- 术语漂移（同一概念跨文件不同名称）
- 数据实体跨文件不一致（plan 有、spec 无，或反之）
- 任务顺序与依赖矛盾（例如集成先于基础设施
