Specification Analysis Report
【免费下载链接】spec-kit💫 Toolkit to help you get started with Spec-Driven Development项目地址: https://gitcode.com/GitHub_Trending/sp/spec-kit
| ID | Category | Severity | Location(s) | Summary | Recommendation |
|---|---|---|---|---|---|
| A1 | Duplication | HIGH | spec.md:L120-134 | Two similar requirements ... | Merge phrasing; keep clearer version |
(Add one row per finding; generate stable IDs prefixed by category initial.)
Coverage Summary Table:
| Requirement Key | Has Task? | Task IDs | Notes |
|---|
Constitution Alignment Issues:(if any)
Unmapped Tasks:(if any)
Metrics:
- Total Requirements
- Total Tasks
- Coverage % (requirements with >=1 task)
- Ambiguity Count
- Duplication Count
- Critical Issues Count
要点：发现条目用**类别首字母前缀的稳定 ID**（A1、B2……），Location 精确到文件与行号区间，保证可追踪；Coverage Summary 逐需求回答"是否有任务覆盖"；Metrics 汇总六个量化指标，使报告本身可比较、可归档。 ### 4.7 步骤 7–9：下一步建议、修复提议与后置钩子 - **步骤 7（Next Actions）**：报告末尾输出简洁的后续行动块。存在 CRITICAL 时，建议先解决再进入 `/speckit.implement`；仅有 LOW/MEDIUM 时可继续推进，但附改进建议。并给出**显式命令建议**，例如"Run `/speckit.specify` with refinement"、"Run `/speckit.plan` to adjust architecture"、"Manually edit tasks.md to add coverage for 'performance-metrics'"——与 [docs/reference/agentic-sdd.md](https://link.gitcode.com/i/c5a0095ffe136675eba748fee4b999a9) "回到拥有问题的步骤去修"的原则完全一致； - **步骤 8（Offer Remediation）**：询问用户"是否需要为 Top N 问题给出具体的修复编辑建议？"——**绝不自动应用**，与步骤 0 的只读铁律闭环； - **步骤 9（after_analyze 钩子）**：报告完成后，对 `.specify/extensions.yml` 的 `hooks.after_analyze` 键执行与 before_analyze 完全对称的检查逻辑（`enabled` 过滤、`condition` 不自行求值、`optional` 决定打印提示还是强制执行并等待完成、无效 YAML 静默跳过、无钩子静默略过）。 ## 五、Operating Principles：上下文效率与行为准则 模板最后两节是 Agent 执行时的硬约束，值得单独强调： **Context Efficiency（上下文效率）** - 最小高信号 token：聚焦可执行发现，不追求穷尽式文档； - 渐进式披露：增量加载工件，不把全部内容塞进分析； - token 高效输出：发现表限制 50 行，超出部分摘要化； - 确定性结果：无变更重跑应产生一致的 ID 与计数（可复算、可比对）。 **Analysis Guidelines（分析准则）** - 绝不修改文件（只读分析）； - 绝不虚构缺失章节——没有就如实报告； - 宪章违规优先（永远是 CRITICAL）； - 用具体实例胜过罗列泛化规则（引用特定条目，而非通用模式）； - 零问题也要优雅报告——输出带覆盖统计的成功报告，而不是沉默。 ## 六、从模板到落地：安装、调用与三端脚本一致性 **安装视角**：spec-kit 通过 `specify init` 初始化项目时，会把 [templates/commands/](https://link.gitcode.com/i/08d80f25d822c198f0e41141b12df1e0) 下的全部命令模板渲染进目标 Agent 的指令/技能目录，并按 [src/specify_cli/integrations/](https://link.gitcode.com/i/5439ea8d516835cfa91e8536b063607a) 中各集成的 `Integration` 实现替换 `{SCRIPT}`、`{ARGS}`、`__SPECKIT_COMMAND_*__` 等占位符。[src/specify_cli/integrations/base.py](https://link.gitcode.com/i/ecc0cdcfe88bf8fb6ae3b547391d21e8) 中 `_CORE_COMMAND_TEMPLATE_ORDER` 元组把 `analyze` 列为十个核心命令模板之首，说明 analyze 属于所有集成统一分发的核心能力，而非可选扩展。 **调用视角**：初始化完成后，在支持对应命令风格的环境中直接输入： ```text /speckit.analyze /speckit.analyze 重点核对性能成功标准是否都有对应任务 # $ARGUMENTS 注入用户关注点【免费下载链接】spec-kit💫 Toolkit to help you get started with Spec-Driven Development项目地址: https://gitcode.com/GitHub_Trending/sp/spec-kit
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
