用途:检查现有 Terraform 资源或数据源实现,产出 OpenSpec 需求文档(spec.md),记录其行为。
主要能力:定位实现包(Plugin Framework 搜索 req.ProviderTypeName + "_...";SDK 在 internal/provider/provider.go 定义);按 reference.md 清单检查代码路径,涵盖 Schema、Metadata、CRUD、Connection、Compatibility、Mapping、Lifecycle;按 OpenSpec 结构撰写文档,含 ## Purpose、可选 ## Schema、## Requirements(### Requirement: 与 #### Scenario: 块),需求正文使用 SHALL / MUST。
使用方式:用户指定实体(如 elasticstack_elasticsearch_security_role)或实现路径(如 internal/elasticsearch/security/role);输出到 openspec/specs/<capability>/spec.md,capability id 采用 <backend>-<area>-<resource>;标题下写 Resource implementation: 或 Data source implementation: 及 Go 包路径。
适用场景:为已有资源/数据源补写规范、梳理行为与需求追溯。
限制:所有需求须可追溯到实现(文件/函数或逻辑),不得编造行为;Schema 与需求须一致;有状态升级时需包含 StateUpgrade 需求。参考 dev-docs/high-level/openspec-requirements.md 与 openspec/specs/elasticsearch-security-role/spec.md。