用途:为指定目的(SpecPurpose)创建新的规格说明文件,定义解决方案组件的需求、约束与接口,使其清晰、无歧义、结构化,便于生成式 AI 有效使用。
主要能力与要求:使用精确、明确、无歧义的语言;区分需求、约束与建议;用标题、列表、表格等结构化格式便于解析;避免习语、隐喻和依赖上下文的引用;定义所有缩写与领域术语;在适用处包含示例与边界情况;文档自包含,不依赖外部上下文。
保存与命名:文件保存到 /spec/ 目录,命名遵循 spec-[a-z0-9-]+.md,名称应描述内容,并以高层目的开头,取值为 schema、tool、data、infrastructure、process、architecture 或 design 之一。文件须为格式良好的 Markdown。
模板结构:包含 front matter(title、可选 version、date_created、可选 last_updated、可选 owner、可选 tags),以及 Introduction、1. Purpose & Scope、2. Definitions、3. Requirements, Constraints & Guidelines(用 REQ-001、SEC-001、CON-001、GUD-001、PAT-001 等编号)、4. Interfaces & Data Contracts、5. Acceptance Criteria(Given-When-Then)、6. Test Automation Strategy、7. Rationale & Context、8. Dependencies & External Integrations(EXT、SVC、INF、DAT、PLT、COM 分类,聚焦架构与业务依赖而非具体包版本)、9. Examples & Edge Cases、10. Validation Criteria、11. Related Specifications / Further Reading。
适用场景:需要为软件方案编写机器可读、自包含规格说明,并供生成式 AI 后续消费或生成代码时使用。
限制:资料未提供安装命令、收费、价格、平台支持或具体使用步骤;模板中测试框架示例(如 MSTest、FluentAssertions、Moq)仅作为 .NET 场景示例出现,并非强制要求。