Specification Analysis Report【免费下载链接】spec-kit Toolkit to help you get started with Spec-Driven Development项目地址: https://gitcode.com/GitHub_Trending/sp/spec-kitIDCategorySeverityLocation(s)SummaryRecommendationA1DuplicationHIGHspec.md:L120-134Two similar requirements ...Merge phrasing; keep clearer version(Add one row per finding; generate stable IDs prefixed by category initial.)Coverage Summary Table:Requirement KeyHas Task?Task IDsNotesConstitution Alignment Issues:(if any)Unmapped Tasks:(if any)Metrics:Total RequirementsTotal TasksCoverage % (requirements with 1 task)Ambiguity CountDuplication CountCritical Issues Count要点发现条目用**类别首字母前缀的稳定 ID**A1、B2……Location 精确到文件与行号区间保证可追踪Coverage Summary 逐需求回答是否有任务覆盖Metrics 汇总六个量化指标使报告本身可比较、可归档。 ### 4.7 步骤 7–9下一步建议、修复提议与后置钩子 - **步骤 7Next 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) 回到拥有问题的步骤去修的原则完全一致 - **步骤 8Offer Remediation**询问用户是否需要为 Top N 问题给出具体的修复编辑建议——**绝不自动应用**与步骤 0 的只读铁律闭环 - **步骤 9after_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），仅供参考