Speckit Clarify Zh

用户输入

$ARGUMENTS

您必须在继续之前考虑用户输入（如果不为空）。

大纲

目标：检测并减少活动功能规格中的歧义或缺失决策点，并将澄清直接记录在规格文件中。

注意：此澄清工作流程预计在调用 /speckit.plan 之前运行（并完成）。如果用户明确表示他们正在跳过澄清（例如，探索性刺探），您可以继续，但必须警告下游返工风险会增加。

执行步骤：

scripts: sh: .specify/scripts/bash/check-prerequisites.sh --json --paths-only ps: .specify/scripts/powershell/check-prerequisites.ps1 -Json -PathsOnly

1. 从仓库根目录运行一次 {SCRIPT}（组合 --json --paths-only 模式 / -Json -PathsOnly）。解析最小 JSON 负载字段：

   • FEATURE_DIR
   • FEATURE_SPEC
   • （可选捕获 IMPL_PLAN, TASKS 用于未来的链式流程。）
   • 如果 JSON 解析失败，则中止并指示用户重新运行 speckit-specify 或验证功能分支环境。
   • 对于参数中的单引号，如 "I'm Groot"，使用转义语法：例如 'I'''m Groot'（或者如果可能的话使用双引号："I'm Groot"）。

2. 加载当前规格文件。使用此分类法执行结构化歧义和覆盖扫描。对于每个类别，标记状态：清晰 / 部分 / 缺失。生成用于优先级排序的内部覆盖图（除非不问问题，否则不要输出原始图）。

   功能范围和行为：

   • 核心用户目标和成功标准
   • 明确的范围外声明
   • 用户角色 / 人物区分

   领域和数据模型：

   • 实体、属性、关系
   • 身份和唯一性规则
   • 生命周期/状态转换
   • 数据量 / 规模假设

   交互和用户体验流程：

   • 关键用户旅程 / 序列
   • 错误/空/加载状态
   • 可访问性或本地化注释

   非功能性质量属性：

   • 性能（延迟、吞吐量目标）
   • 可扩展性（水平/垂直、限制）
   • 可靠性和可用性（正常运行时间、恢复期望）
   • 可观察性（日志、指标、跟踪信号）
   • 安全性和隐私（认证/授权、数据保护、威胁假设）
   • 合规性 / 监管约束（如果有）

   集成和外部依赖：

   • 外部服务/API 和故障模式
   • 数据导入/导出格式
   • 协议/版本假设