用途:根据新需求或现有代码的变更,更新已有规格文件 ${file},使其清晰、无歧义地定义解决方案组件的需求、约束与接口,便于生成式 AI 使用。
主要能力与写作要求:使用精确、明确、无歧义的语言;区分需求、约束与建议;用标题、列表、表格等结构化格式便于解析;避免习语、隐喻与依赖上下文的引用;定义全部缩写与领域术语;在适用处给出示例与边界情况;确保文档自包含,不依赖外部上下文。
存放与命名:规格保存在 /spec/ 目录,命名为 [a-z0-9-]+.md,名称应描述内容,并以高层用途开头,取值为 schema、tool、data、infrastructure、process、architecture 或 design 之一。文件须为格式良好的 Markdown。
模板结构:含 front matter(title、version、date_created、last_updated、owner、tags),正文包含 Introduction、Purpose & Scope、Definitions、Requirements/Constraints/Guidelines(以 REQ-、SEC-、CON-、GUD-、PAT- 等编号)、Interfaces & Data Contracts、Acceptance Criteria(Given-When-Then)、Test Automation Strategy、Rationale & Context、Dependencies & External Integrations(EXT-、SVC-、INF-、DAT-、PLT-、COM- 编号)、Examples & Edge Cases、Validation Criteria、Related Specifications / Further Reading。依赖部分应聚焦架构与业务依赖,而非具体包版本。
限制:资料未提供安装命令、收费与平台信息、具体调用方式或自动化运行步骤,暂未提供。