OpenSpec 初始化后会在 openspec/ 目录下生成 config.yaml 配置文件,这是框架的核心配置入口。通过合理配置该文件,可以为 AI 生成的所有变更产物注入项目上下文约束,避免重复在每次提示词中说明。
以下是项目中实际使用的 config.yaml 配置:
config.yaml
schema: spec-driven # 项目上下文(可选):在 AI 创建各类产物时会自动注入 # 适合放置技术栈说明、规范要求、领域知识等 context:| Output language: All artifact content must be written in Simplified Chinese, including section titles, descriptions, scenario text, and task items. # 各产物的独立约束规则 rules: tasks: -| When a task involves E2E test cases, the TC ID generating should follow the openspec-e2e skill conventions.
需求描述质量决定输出质量 :在 /opsx:explore 阶段投入足够多的时间来澄清和细化需求,是整个 SDD 流程质量的关键。模糊的需求描述几乎必然导致实现偏差,与其在后期反复修复,不如在探索阶段多花时间打磨需求共识。由于需求澄清并不会创建持久化存储的文件,因此在这一阶段尽可能使用上下文足够大的模型(如 Claude Opus 4.6 1M 模型),以及使用思考深度更好的策略(如 Effort: Max )。
推荐使用中文(如果团队语言是中文)。这类文档的主要受众是团队成员,中文可大幅降低阅读和维护成本,整体收益高于大模型对英文的些微语义优势。通过在 openspec/config.yaml 的 context 字段中声明 Output language: All artifact content must be written in Simplified Chinese ,即可确保所有 AI 生成的规范文档统一使用简体中文输出,无需在每次提示词中重复说明。