用途:把当前对话上下文与对代码库的理解综合成一份规格说明(spec),并发布到项目的问题跟踪器。该技能明确要求不要访谈用户,只综合已知信息。
主要能力与流程:先探索仓库以了解代码库现状;在规格中统一使用项目领域词汇表,并遵守相关区域的 ADR。随后勾勒测试接缝(seams),优先复用已有接缝,尽量使用最高层接缝,接缝越少越好,理想为一个;若需新接缝,在尽可能高的位置提出。默认用户认可所提接缝后,按模板撰写规格并发布到问题跟踪器,同时打上 ready-for-agent 分类标签,无需额外分类。
规格模板包含:问题陈述(从用户视角描述问题)、解决方案(从用户视角描述方案)、用户故事(较长的编号列表,格式为 As an…, I want a…, so that…,需覆盖功能各方面)、实现决策(涉及模块、接口、技术澄清、架构决策、模式变更、API 契约、具体交互;不写具体文件路径或代码片段,除非原型片段比文字更精确地编码了决策,如状态机、reducer、schema、类型形状,并注明来自原型)、测试决策(好测试的标准是只测外部行为而非实现细节、被测模块、代码库中类似测试的先例)、范围外内容、进一步说明。
使用前提:问题跟踪器与分类标签词汇应已提供,否则需先运行 /setup-utarn-skills。
限制:不进行用户访谈;不包含具体文件路径与代码片段(原型例外);资料未提供具体跟踪器类型、安装方式或收费信息。