Agent Skills
› Azure/agent-landing-zone
› terraform-parity-proposal
terraform-parity-proposal
GitHub将已批准的Bicep到Terraform对齐交接内容转换为只读、供人类审查的提案计划。严格验证审批状态、溯源信息及安全合规性,确保不执行写入操作,仅输出差异分析与影响评估报告。
触发场景
需要生成Terraform与Bicep代码对齐的审查提案
验证结构化交接数据的合规性与完整性
安装
npx skills add Azure/agent-landing-zone --skill terraform-parity-proposal -g -y
SKILL.md
Frontmatter
{
"name": "terraform-parity-proposal",
"description": "Converts an approved structured parity handoff into a read-only, human-reviewable proposal plan for the allow-listed Terraform repository."
}
Terraform parity proposal
Boundary
- Bicep is the source of truth and this repository remains read-only.
- The only target is
Azure/terraform-azurerm-avm-ptn-aiml-landing-zone. - Terraform source belongs only in the target repository.
- Never use credentials, merge, deploy, release, publish, create a pull request, or bypass target-repository review and branch protection.
Workflow
- Validate the handoff against
parity/schemas/terraform-handoff.schema.json. - Require
approval.status=approvedand exactly one valid, immutable provenance form. Pending, rejected, and superseded drafts cannot be consumed, dispatched, or used for T033. Stop if the baseline is stale. - For approved baseline provenance, require
inventoryCommitShaandinventoryReviewUrl; usegit show <inventoryCommitSha>:parity/inventory.json, hash its exact bytes, and verify its baseline ID and Bicep/Terraform commits. Never infer the inventory commit fromsource.commitSha. Issue #136 supplies context, not review or approval. - Confirm every capability exists in the active inventory and the source and
target repositories, refs, and commits match
parity/config.json. - Reject Terraform source, secrets, tenant or subscription IDs, private addresses, and environment-specific names in the handoff.
- Read only the cited Bicep contracts and the allow-listed target baseline.
- Produce a proposal plan, not a patch. Keep standard and network-isolated implications independent.
- Hand the plan to a human-approved contribution workflow in the target repository.
Acceptance checklist
- Existing inputs, outputs, and defaults are preserved, or migration, deprecation, and semantic-version impact are explicit.
- Required behavior and acceptance criteria cover every capability.
- Managed identity and least-privilege control-plane and data-plane RBAC are preferred.
- Local authentication, secret handling, public access, private endpoints, DNS, routes, subnet delegation, and dependency ordering are explicit.
- AVM formatting, lint, documentation, examples, tests, and pattern-module checks are identified.
- Hub-spoke and arbitrary optional-feature combinations remain excluded.
- Each scenario requires its own approved deployment and reviewed comparison; static validation and plan output do not prove parity.
Exit conditions
Return the proposal plan, affected contracts, expected semantic-version impact, target validation commands, evidence still required, exclusions, and open risks. Stop without a plan if approval, provenance, allow-list, capability, security, or compatibility checks fail. Never claim parity or perform a write.
版本历史
- 7fb5e36 当前 2026-10-20 05:55


