Appearance
OpenSpec 工作流
目录
| 位置 | 内容 |
|---|---|
openspec/config.yaml | 项目上下文与产出约束 |
openspec/project.json | 包路径与验证命令事实 |
openspec/rules/enforced/ | 参与结构检查的项目不变量和结构规则 |
openspec/rules/advisory/ | 需要按任务阅读的接口、组件、工具链约定 |
openspec/schemas/devops-workflow/ | 本地开发流程与模板 |
openspec/specs/ | 长期能力规格与索引 |
openspec/changes/ | 进行中变更；完成后归档到 archive |
openspec/state/ | 当前已验证事实 |
openspec/design/ | 设计决策与说明 |
创建变更
在根目录使用已安装的 OpenSpec CLI：
bash
openspec new change <change-name>
openspec status --change <change-name>
openspec instructions interview --change <change-name>本仓库默认 schema 为 devops-workflow，顺序为需求访谈 interview、探索 explore、 提案 proposal、能力 specs、设计 design、任务 tasks、实现后校验 verify。 CLI 提供产出指引，开发者按模板填写；不自动生成业务结论。
能力名使用稳定的领域名词，例如 workspace-tooling，不能以本次修复名称代替。 新增能力使用 ADDED，既有能力调整使用 MODIFIED/REMOVED；需求 ID 在能力内稳定。
检查与归档
bash
pnpm openspec:check
pnpm openspec:validate
openspec archive <change-name>openspec:check 是仓库内的无依赖检查，验证工作区、规则索引、能力与场景格式及变更完整性。 它不替代 OpenSpec CLI 的严格校验。所有运行测试与构建结果须真实记录到变更 verify 文档。 归档前同步主规格和能力索引；state 只写已验证结果，失败或未执行的检查明确保留。
机械检查仅保证规则文档被索引、必要字段存在等结构约束，Java 分层和安全语义仍须审查与测试。