AGENT SKILL

tag-compliance-automator

Automates AWS tag compliance end-to-end: Organizations tag policies with case-sensitive key/value validation and enforced_for scoping, Resource Groups Tagging API bulk operations, Config managed rules (required-tags, allowed-tag-values) plus custom Lambda rules for 6+ keys, EventBridge + Lambda auto-tagging on EC2/S3/Lambda creation with inherited-tag propagation (EC2 to EBS and ENIs), tag drift detection via Config CI change events, remediation via SSM Automation, cost allocation tag activation via Cost Explorer API, and cross-account consistency via CloudFormation StackSets. Emits AUTOMATION_DEPLOYED with deployment templates or REVIEW_REQUIRED with the specific gap. Use when building tag compliance automation, enforcing a tag schema, wiring auto-tagging, or remediating tag drift across an organization.

License 许可
Apache-2.0
最近更新
2026-09-24
Stars
★ 4
Forks
0

01 前言 Front Matter

name
tag-compliance-automator
license
Apache-2.0
metadata
{ "tags": "aws-organizations, tag-policy, resource-groups-tagging-api, aws-config, eventbridge, lambda, cost-explorer, cloudformation-stacksets, ssm-automation, automate", "phase": "4", "author": "Jacky Chan — AWS Community Builder", "domain": "aws-cloudops", "family": "Governance", "version": "0.1.0", "keywords": "AWS Organizations, Tag Policy, TagPolicy, case_sensitive, enforced_for, allowed_values, Resource Groups Tagging API, tag-resources, untag-resources, get-resources, AWS Config, required-tags, allowed-tag-values, tag drift, EventBridge, Lambda auto-tagging, tag propagation, EC2 EBS ENI, cost allocation tags, Cost Explorer API, CloudFormation StackSets, SSM Automation, tag compliance, tag schema, Environment Owner CostCenter Project", "task_type": "automate", "complexity": "high", "entry_point": "false", "skill_class": "capability", "when_to_use": "Designing Organizations tag policies with case-sensitive key/value validation, building EventBridge + Lambda auto-tagging pipelines with inherited-tag propagation (EC2 to EBS/ENI), running Resource Groups Tagging API bulk operations, wiring Config required-tags and allowed-tag-values rules with drift detection, remediating tag drift via SSM Automation, activating cost allocation tags programmatically, or enforcing cross-account tag consistency via CloudFormation StackSets.", "requires_llm": "true", "verdict_shape": "AUTOMATION_DEPLOYED | REVIEW_REQUIRED", "lifecycle_status": "active", "invocation_schema": "Input: either (a) a tag compliance requirement (\"enforce Environment, Owner, CostCenter, Project tags on all EC2, S3, and RDS resources with auto-tagging and drift remediation\", \"propagate tags from EC2 to EBS volumes and ENIs on creation\", \"activate cost allocation tags programmatically\"), OR (b) an existing tag policy, Config rule, or EventBridge auto-tagger to audit and harden. Output: deterministic COMPLIANCE block per requirement — POLICY/DETECTION/AUTOMATION/ PROPAGATION/REMEDIATION/COST/VERDICT — where VERDICT is AUTOMATION_DEPLOYED (templates ready and validated) or REVIEW_REQUIRED (specific gap cited, e.g., manual Billing-console step or untested custom runbook).", "supports_pipeline": "true", "activation_triggers": "tag compliance automation, Organizations tag policy case_sensitive, auto-tag on creation EventBridge Lambda, tag propagation EC2 EBS ENI, Resource Groups Tagging API bulk, tag-resources untag-resources get-resources, required-tags allowed-tag-values Config rule, tag drift detection remediation, cost allocation tag activation, cross-account tag consistency StackSets, tag schema enforcement, Environment Owner CostCenter Project tags" }
description
Automates AWS tag compliance end-to-end: Organizations tag policies with case-sensitive key/value validation and enforced_for scoping, Resource Groups Tagging API bulk operations, Config managed rules (required-tags, allowed-tag-values) plus custom Lambda rules for 6+ keys, EventBridge + Lambda auto-tagging on EC2/S3/Lambda creation with inherited-tag propagation (EC2 to EBS and ENIs), tag drift detection via Config CI change events, remediation via SSM Automation, cost allocation tag activation via Cost Explorer API, and cross-account consistency via CloudFormation StackSets. Emits AUTOMATION_DEPLOYED with deployment templates or REVIEW_REQUIRED with the specific gap. Use when building tag compliance automation, enforcing a tag schema, wiring auto-tagging, or remediating tag drift across an organization.
compatibility
Agent runtime that reads SKILL.md (Claude Code, Cursor, Windsurf, Codex, Gemini). No AWS CLI required for offline policy design. Live deployment uses aws organizations enable-policy-type, create-policy, update-policy, attach-policy, aws resourcegroupstaggingapi tag-resources, untag-resources, get-resources, aws configservice put-config-rule, put-remediation-configurations, aws ce update-cost-allocation-tags-status, aws ssm create-document, start-automation-execution, aws lambda...

02 资源文件 20

03 SKILL.md 正文

Tag Compliance Automator

Mindset

Moved to references/advanced-patterns.md. One-line: four layers — define (TagPolicy enforced_for + case rules) → detect (Config rules + drift) → propagate (EventBridge auto-tagger + EC2→EBS/ENI) → remediate (SSM); a gap in ANY layer is a silent failure; cost allocation tags are inactive until activated in Billing.

Quick navigation

You want to... Go to
Design an Organizations TagPolicy with case-sensitive enforcement Step 1 + Appendix A
Pick between Config required-tags and a custom Lambda rule Step 2
Wire an EventBridge auto-tagger for new resources Step 3
Propagate tags from EC2 to EBS volumes and ENIs Step 4
Detect and remediate tag drift via Config Step 5 + Step 6
Bulk-tag existing resources via Resource Groups Tagging API Step 7
Activate cost allocation tags programmatically Step 8
Enforce cross-account tag consistency via StackSets Step 9
Avoid common tag-policy and propagation pitfalls Anti-Patterns

Critical rules at a glance (do NOT bury these)

  1. enforced_for is the only enforcement hook in a TagPolicy. A policy with allowed_values but no enforced_for entries is advisory. Always list resource types under enforced_for for every tag key you want enforced.
  2. case_sensitive defaults to true and mismatches break silently. If the policy declares Environment and a resource is tagged environment, the policy does not match. Config required-tags also checks the exact key name. Normalize casing in the auto-tagger before stamping.
  3. Config required-tags checks at most 5 tag keys per rule. To enforce 6+ keys, deploy a second rule (required-tags-ext) or a custom Lambda rule.
  4. EC2 tags do NOT propagate to EBS volumes or ENIs. The RunInstances API tags only the instance. An EventBridge-driven Lambda must call ec2:create-tags on child resources.
  5. Cost allocation tag activation is account-scoped and per-key. The ce update-cost-allocation-tags-status API activates a tag key for the payer account only. Propagation delay is up to 24 hours.

Pre-flight: data requirements

Input Source Why
Existing tag policies organizations list-policies --filter TAG_POLICY Avoid overwriting an in-use policy
Organization root ID organizations list-roots Attachment target for the policy
Tag policy type enabled organizations describe-organization AvailablePolicyTypes Must enable TAG_POLICY before attaching
Config recorder status configservice describe-configuration-recorders Rules cannot evaluate without a recorder
Current cost allocation tag status ce list-cost-allocation-tags Avoid redundant activation calls
Sample resource tag coverage resourcegroupstaggingapi get-resources Baseline before enforcement
SSM service role ARN iam get-role on the SSM automation role Remediation execution identity

If the input is malformed (missing tag schema, ambiguous resource type list), emit:

COMPLIANCE: <reference>
VERDICT: ERROR
REASON: Cannot design tag compliance automation — tag schema and target resource types are required.
GAP: Re-supply the required tag keys, allowed values, and the resource types in scope.

Process — Compliance automation design (apply in order)

Step 0: Expert knowledge — non-obvious TagPolicy and Config behaviors

Moved to references/advanced-patterns.md. Eight expert behaviors: child-OU policy OVERRIDES root (no merge), enforced_for resource-type typos silently ignored, required-tags InputParameters must be a JSON string, Tagging API eventual consistency, assumed-role owner derivation, allowed-tag-values is one key per rule, 24h cost-tag propagation delay, CI events only for recorded types.

Step 1: Design the Organizations TagPolicy

The TagPolicy JSON declares per tag key: TagKey, ExpectedStringValues (optional allowed values), and EnforcedFor (resource types that must comply). Wrap under a tags object.

{
  "tags": {
    "Environment": {
      "TagKey": "Environment",
      "ExpectedStringValues": ["dev", "staging", "prod"],
      "EnforcedFor": ["AWS::EC2::Instance", "AWS::S3::Bucket", "AWS::RDS::DBInstance", "AWS::Lambda::Function"]
    },
    "Owner": {
      "TagKey": "Owner",
      "EnforcedFor": ["AWS::EC2::Instance", "AWS::S3::Bucket"]
    },
    "CostCenter": {
      "TagKey": "CostCenter",
      "ExpectedStringValues": ["cc-100", "cc-200", "cc-300"],
      "EnforcedFor": ["AWS::EC2::Instance", "AWS::S3::Bucket"]
    },
    "Project": {
      "TagKey": "Project",
      "EnforcedFor": ["AWS::EC2::Instance", "AWS::Lambda::Function"]
    }
  }
}

CLI deployment:

aws organizations enable-policy-type --root-id r-xxxx --policy-type TAG_POLICY
aws organizations create-policy --type TAG_POLICY --name baseline-compliance-tag-policy \
  --description "Enforced tag keys: Environment, Owner, CostCenter, Project" --content file://tag-policy.json
aws organizations attach-policy --policy-id p-xxxxxxx --target-id r-xxxx
TagPolicy shape Behavior Verdict impact
allowed_values set, enforced_for empty Advisory — no operation blocked REVIEW_REQUIRED (enforcement gap)
allowed_values set, enforced_for populated Enforced — non-compliant op returns ConstraintViolation AUTOMATION_DEPLOYED
No allowed_values, enforced_for populated Key presence enforced, value not validated AUTOMATION_DEPLOYED (presence only)

Step 2: Choose the Config rule pattern

Pattern Rule type Use case Limit
Required keys presence required-tags (managed) Enforce N tag keys exist Max 5 keys per rule
Allowed values per key allowed-tag-values (managed) Enforce value allowlist One key per rule
Custom multi-key validation Custom Lambda rule 6+ required keys, regex, conditional logic Lambda maintenance
Tag drift detection Custom Lambda on Config CI change Detect tag removal or value change Requires recorder coverage

Deploy required-tags for the first 5 keys:

aws configservice put-config-rule --config-rule '{
  "ConfigRuleName": "required-tags-core",
  "Source": {"Owner": "AWS", "SourceIdentifier": "REQUIRED_TAGS"},
  "Scope": {"ComplianceResourceTypes": ["AWS::EC2::Instance", "AWS::S3::Bucket", "AWS::RDS::DBInstance", "AWS::Lambda::Function"]},
  "InputParameters": "{\"tag1Key\":\"Environment\",\"tag2Key\":\"Owner\",\"tag3Key\":\"Project\",\"tag4Key\":\"CostCenter\",\"tag5Key\":\"Application\"}"
}'

For the 6th+ required key, deploy a second rule (required-tags-ext) or a custom Lambda rule.

Step 3: Wire the EventBridge auto-tagger

The auto-tagger fires on resource-creation events and stamps inherited or derived tags. It must be idempotent and case-normalized.

aws events put-rule --name auto-tag-on-create --event-pattern '{
  "source": ["aws.ec2", "aws.s3", "aws.lambda"],
  "detail-type": ["AWS API Call via CloudTrail"],
  "detail": {
    "eventSource": ["ec2.amazonaws.com", "s3.amazonaws.com", "lambda.amazonaws.com"],
    "eventName": ["RunInstances", "CreateBucket", "CreateFunction20150331"]
  }
}'

Lambda handler must: (a) derive Environment from an account-to-env map, (b) derive Owner from the IAM identity (normalize role sessions via lookup), (c) normalize key casing before calling create-tags, and (d) propagate to child resources (Step 4). Common errors:

Error Cause Fix
AccessDenied on create-tags Lambda role missing ec2:CreateTags Add inline policy for ec2:CreateTags on *
Tag stamped but resource still NON_COMPLIANT Key casing mismatch Normalize key name in Lambda before create-tags
EventBridge rule fires but Lambda not invoked Target not attached or wrong permission events:put-targets plus lambda:InvokePermission

Step 4: Propagate tags from EC2 to EBS volumes and ENIs

The RunInstances API returns instance IDs, volume IDs, and ENI IDs. The auto-tagger Lambda must call ec2:create-tags on each child resource. This is the most common propagation gap — the instance is tagged but volumes and ENIs are not.

def propagate_to_children(instance_id, tags):
    desc = ec2.describe_instances(InstanceIds=[instance_id])
    for r in desc["Reservations"]:
        for i in r["Instances"]:
            volume_ids = [v["Ebs"]["VolumeId"] for v in i.get("BlockDeviceMappings", []) if "Ebs" in v]
            eni_ids = [n["NetworkInterfaceId"] for n in i.get("NetworkInterfaces", [])]
            if volume_ids:
                ec2.create_tags(Resources=volume_ids, Tags=tags)
            if eni_ids:
                ec2.create_tags(Resources=eni_ids, Tags=tags)
Parent Child inherits API
EC2 Instance EBS volumes, ENIs ec2:create-tags on VolumeId and NetworkInterfaceId
RDS DB Instance Automated snapshots rds:add-tags-to-resource
Lambda Function Versions, aliases Automatic — no action needed

Step 5: Detect tag drift via Config

Tag drift occurs when tags are modified after creation. Config emits a configuration-item change event when recorded tag state changes.

aws events put-rule --name tag-drift-detector --event-pattern '{
  "source": ["aws.config"],
  "detail-type": ["Config Configuration Item Change"],
  "detail": {"configurationItem": {"resourceType": ["AWS::EC2::Instance", "AWS::S3::Bucket"]}}
}'

A custom Lambda evaluates the new tag set against the schema and emits a finding to EventBridge or Security Hub. For remediation, hand off to SSM Automation (Step 6).

Step 6: Remediate non-compliant and drifted tags via SSM Automation

For each Config rule emitting NON_COMPLIANT on tags, wire a remediation configuration pointing at an SSM Automation runbook. The custom runbook adds the missing tag with a placeholder value:

---
schemaVersion: '0.3'
assumeRole: '{{ AutomationAssumeRole }}'
description: 'Add a missing required tag (placeholder value)'
parameters:
  ResourceId: {type: String, description: 'Injected by Config via RESOURCE_ID'}
  TagKey: {type: String}
  TagValue: {type: String, description: 'Placeholder; secondary human-correction queue required'}
  AutomationAssumeRole: {type: String}
mainSteps:
  - name: AddTag
    action: aws:executeAwsApi
    inputs:
      Service: ec2
      Api: CreateTags
      Resources: ['{{ ResourceId }}']
      Tags: [{Key: '{{ TagKey }}', Value: '{{ TagValue }}'}]
    isCritical: true
    onFailure: abort

Wire the remediation:

aws configservice put-remediation-configurations --remediation-configurations '[{
  "ConfigRuleName": "required-tags-core",
  "TargetType": "SSM_DOCUMENT",
  "TargetId": "Custom-AddRequiredTagEC2",
  "Automatic": false,
  "MaximumAutomaticAttempts": 3,
  "RetryAttemptSeconds": 600,
  "Parameters": {
    "ResourceId": {"ResourceValue": {"Value": "RESOURCE_ID"}},
    "TagKey": {"StaticValue": {"Values": ["Environment"]}},
    "TagValue": {"StaticValue": {"Values": ["unknown"]}},
    "AutomationAssumeRole": {"StaticValue": {"Values": ["arn:aws:iam::111111111111:role/aws-service-role/AmazonSSMAutomationRole/AWS-SSM-AutomationExecutionRole"]}}
  }
}]'

Trigger decision: default to Automatic: false for tag remediation. Placeholder values (Environment=unknown) satisfy Config but pollute cost reports and ABAC. Switch to Automatic: true only for derived-value remediations where the runbook can compute the correct value from resource context.

Step 7: Bulk-tag existing backlog via Resource Groups Tagging API

aws resourcegroupstaggingapi tag-resources \
  --resource-arn-list \
    arn:aws:ec2:us-east-1:111111111111:instance/i-0abc123 \
    arn:aws:s3:::app-uploads-bucket-prod \
  --tags Environment=prod,Owner=platform-team

aws resourcegroupstaggingapi get-resources \
  --tag-filters Key=Environment,Values=[] \
  --resources-per-page 50

The API supports up to 100 resources per call. Always check FailedResourcesMap in the response — partial failures are silent if the caller does not inspect.

Step 8: Activate cost allocation tags programmatically

aws ce update-cost-allocation-tags-status --cost-allocation-tags-status '[
  {"TagKey": "Environment", "Status": "Active"},
  {"TagKey": "Owner", "Status": "Active"},
  {"TagKey": "CostCenter", "Status": "Active"},
  {"TagKey": "Project", "Status": "Active"}
]'

Gap class — manual Billing-console step: some payer accounts gate ce:UpdateCostAllocationTagsStatus behind the Billing console's "IAM User and Role Access to Billing Information" setting. If the API returns AccessDeniedException, an administrator must enable it in the Billing console. The verdict MUST be REVIEW_REQUIRED.

Step 9: Enforce cross-account tag consistency via CloudFormation StackSets

aws cloudformation create-stack-set \
  --stack-set-name tag-compliance-baseline \
  --template-body file://tag-compliance-stackset.yaml \
  --permission-model SERVICE_MANAGED \
  --auto-deployment Enabled=true,RetainStacksOnAccountRemoval=false \
  --capabilities CAPABILITY_IAM

aws cloudformation create-stack-instances \
  --stack-set-name tag-compliance-baseline \
  --deployment-targets OrganizationalUnitIds=["ou-xxxx-xxxxxxxx"] \
  --regions us-east-1 us-west-2

The Organizations TagPolicy itself cascades natively; the StackSet is for Config rules and SSM documents across accounts.

Output format

COMPLIANCE: <reference>
SCOPE: <accounts / OUs / regions>
SCHEMA:
  - Required keys: <list>
  - Allowed values: <per-key summary>
  - Case sensitivity: <true | false>
POLICY:
  - Type: Organizations TagPolicy (name) + Config rules (names)
  - Attached to: <root / OU / accounts>
  - enforced_for: <resource types>
DETECTION:
  - Config rules: <list>
  - Drift detection: <enabled | disabled> via <mechanism>
AUTOMATION:
  - Auto-tagging: EventBridge + Lambda on <events>
  - Tag propagation: <parent -> child mappings>
  - Remediation: SSM <document name>, trigger <automatic | manual>
PROPAGATION:
  - EC2 -> EBS: <covered>
  - EC2 -> ENI: <covered>
COST:
  - Cost allocation tags: <active | inactive> for <keys>
  - Activation method: <API | manual-console>
CROSS_ACCOUNT:
  - StackSet: <name>, deployment targets <OUs>, regions <list>
VERDICT: AUTOMATION_DEPLOYED | REVIEW_REQUIRED
GAP: <if REVIEW_REQUIRED, the specific missing piece>
TEMPLATE: <CLI snippets or YAML for the full stack>

Worked example — AUTOMATION_DEPLOYED, full stack

COMPLIANCE: org-tag-compliance-rollout
SCOPE: org root r-xxxx, all member accounts, us-east-1
SCHEMA:
  - Required keys: Environment, Owner, CostCenter, Project, Application
  - Allowed values: Environment=[dev,staging,prod], CostCenter=[cc-100,cc-200,cc-300]
  - Case sensitivity: true
POLICY:
  - Type: Organizations TagPolicy (baseline-compliance-tag-policy) + Config required-tags-core + allowed-tag-values-environment
  - Attached to: root r-xxxx
  - enforced_for: AWS::EC2::Instance, AWS::S3::Bucket, AWS::RDS::DBInstance, AWS::Lambda::Function
DETECTION:
  - Config rules: required-tags-core, allowed-tag-values-environment
  - Drift detection: enabled via EventBridge on Config CI change for EC2 and S3
AUTOMATION:
  - Auto-tagging: EventBridge + Lambda on RunInstances, CreateBucket, CreateFunction20150331
  - Tag propagation: EC2 -> EBS volumes, EC2 -> ENIs (covered)
  - Remediation: SSM Custom-AddRequiredTagEC2, manual trigger
PROPAGATION:
  - EC2 -> EBS: covered
  - EC2 -> ENI: covered
COST:
  - Cost allocation tags: active for Environment, Owner, CostCenter, Project
  - Activation method: ce update-cost-allocation-tags-status (API)
CROSS_ACCOUNT:
  - StackSet: tag-compliance-baseline, OUs ou-xxxx-xxxxxxxx, regions us-east-1 us-west-2
VERDICT: AUTOMATION_DEPLOYED
GAP: None — placeholder remediation values require a secondary human-correction queue.
TEMPLATE:
  aws organizations enable-policy-type --root-id r-xxxx --policy-type TAG_POLICY
  aws organizations create-policy --type TAG_POLICY --name baseline-compliance-tag-policy --content file://tag-policy.json
  aws organizations attach-policy --policy-id p-xxxxxxx --target-id r-xxxx
  aws configservice put-config-rule --config-rule <see Step 2>
  aws events put-rule --name auto-tag-on-create --event-pattern <see Step 3>
  aws lambda create-function --function-name auto-tagger --runtime python3.12 --handler auto_tag.lambda_handler --role arn:aws:iam::111111111111:role/AutoTaggerRole --zip-file fileb://auto_tag.zip
  aws ssm create-document --name Custom-AddRequiredTagEC2 --document-type Automation --document-format YAML --content file://add-tag-ec2.yaml
  aws configservice put-remediation-configurations --remediation-configurations <see Step 6>
  aws ce update-cost-allocation-tags-status --cost-allocation-tags-status <see Step 8>

Worked example — REVIEW_REQUIRED, manual Billing step

Moved to references/worked-examples.md. Full REVIEW_REQUIRED report: ENI propagation missing, cost allocation activation blocked (AccessDeniedException), Config recorder blind on S3.

Anti-Patterns — NEVER do these things

  • NEVER deploy a TagPolicy without enforced_for for any key you intend to enforce. Without it, the policy is advisory and AWS does not block non-compliant operations.

  • NEVER assume required-tags validates more than 5 keys. It silently ignores keys beyond the 5th. Deploy a second rule or a custom Lambda.

  • NEVER wire an auto-tagger Lambda without idempotency. EventBridge replays events on failure recovery; a non-idempotent Lambda errors on duplicate tags or overwrites corrected values with stale derived ones.

  • NEVER propagate tags from EC2 to EBS and ENIs without verifying the Lambda execution role has ec2:CreateTags on child resource ARNs. A role scoped to instances only produces silent AccessDenied.

  • NEVER activate cost allocation tags and expect immediate Cost Explorer updates. The API has a 24-hour propagation delay.

  • NEVER rely on Config required-tags for tag value validation. The managed rule checks key presence only. Use allowed-tag-values or a custom Lambda rule for value enforcement.

  • NEVER attach a TagPolicy to a child OU expecting merge with the root policy. Child-OU policies OVERRIDE root policies. To add a key without losing root keys, re-declare every parent key.

  • NEVER set Automatic: true on a tag-remediation runbook that stamps placeholder values. Placeholders satisfy Config but pollute Cost Explorer and ABAC. Use manual trigger plus a human-correction queue.

  • NEVER assume case_sensitive: false in a TagPolicy makes Config required-tags case-insensitive. They are independent systems. Config always matches the exact key name in InputParameters.

  • NEVER ship an auto-tagger without a DLQ on the EventBridge target. EventBridge drops events on Lambda failure after retry exhaustion, producing silent tag gaps.

Configuration dependency graph

Moved to references/advanced-patterns.md. Ordering: enable TAG_POLICY → attach policy → recorder scope → rules / auto-tagger role → remediation wiring → cost allocation → StackSet; five hard ordering constraints.

Pre-flight safety checks

Moved to references/diagnostic-commands.md. Gates: CONFIRM prompt before any state change, back up the TagPolicy, dry-run advisory→enforced via Config, verify StackSet roles.

Appendix A — TagPolicy JSON reference

Moved to references/organizations-tag-policies.md. Field table: TagKey (must match), ExpectedStringValues (optional), EnforcedFor (required for enforcement), CaseSensitive (default true).

Appendix B — Decision tree (which enforcement layer)

Is the tag key required on all resources of a type?
├─ Yes → Does the value need an allowlist?
│       ├─ Yes → TagPolicy with ExpectedStringValues + EnforcedFor
│       │         AND Config allowed-tag-values for drift detection
│       └─ No  → TagPolicy with EnforcedFor (presence) + Config required-tags
└─ No  → Auto-tagger stamps on creation; cost allocation activation

Recent AWS features (2024-2026)

Moved to references/advanced-patterns.md. enforced_for type expansion, CE ProcessingStatus visibility, StackSet drift detection, Tagging API pagination TTL.

Expert heuristic: tag-policy case sensitivity + EventBridge auto-tagger + Config detection

Moved to references/advanced-patterns.md. Non-negotiable: declare case_sensitive explicitly, normalize casing in the auto-tagger, propagate EC2→EBS+ENI in the same handler; includes the case-sensitivity matrix and the propagation diagnostic.

References (load on demand)

Domain

AWS CloudOps / Governance Automation — Tag compliance enforcement and remediation.

AWS documentation

04 同仓库更多 Skills

jhkchan
jhkchan/aws-agent-skills

xray-tracing-deployer

Deploys AWS X-Ray distributed tracing with production-grade configuration: X-Ray daemon deployment (EC2 systemd, ECS sidecar, EKS DaemonSet, Lambda built-in), SDK instrumentation (Java, Python, Node.js, Go, .NET) with annotations and metadata, sampling rules (default reservoir + rate vs custom rules with URL / method / service-name predicates), service map generation, trace query and retrieval, groups and insights, CloudWatch ServiceLens integration, IAM permissions (PutTraceSegments, GetSamplingRules), and latest features (Lambda Powertools tracing, OpenTelemetry / ADOT Collector support, W3C trace context). Emits a READY_TO_DEPLOY checklist with every configuration item verified. Use when enabling X-Ray on a new application, adding tracing to ECS / EKS / Lambda, validating a sampling configuration, or generating daemon deployment CLI and IaC templates. Triggers: X-Ray, distributed tracing, X-Ray daemon, sampling rules, service map, X-Ray SDK, OpenTelemetry, ADOT, Lambda Powertools, CloudWatch ServiceLens.

★ 4
jhkchan
jhkchan/aws-agent-skills

wellarchitected-workload-auditor

Audits AWS Well-Architected Tool workloads for review staleness, per-pillar high-risk issue counts, milestone tracking gaps, and remediation plan completeness. Emits a deterministic verdict (STALE_REVIEW | HIGH_RISK | CONFIG_GAP | OK) per workload with per-pillar risk breakdown, milestone trend analysis, and specific remediation. Use when reviewing Well-Architected workloads, checking WA review freshness, auditing high-risk issues per pillar, validating milestone coverage, or tracking remediation plans.

★ 4
jhkchan
jhkchan/aws-agent-skills

wellarchitected-review-operator

Operates AWS Well-Architected Tool reviews end-to-end — creates workloads, runs pillar reviews (operational excellence, security, reliability, performance, cost optimization, sustainability, Prosperity), answers questions with risk-tier rationale, generates reports and improvement plans, creates milestones, and integrates with Trusted Advisor and Well-Architected Labs. Runs deterministic pre-checks (workload existence, lens availability, pillar coverage), emits the exact update-answer / get-consolidated-report CLI behind a CONFIRM gate, and verifies risk-tier transitions. Emits READY | BLOCKED | COMPLETED. Use when creating a workload, answering pillar questions, generating an improvement plan, creating a milestone, or integrating with Trusted Advisor. Triggers: well-architected tool, well architected review, workload review, pillar, operational excellence, security, reliability, performance, cost optimization, sustainability, prosperity, improvement plan, milestone, trusted advisor.

★ 4
jhkchan
jhkchan/aws-agent-skills

wafv2-web-acl-deployer

Provisions AWS WAFv2 Web ACLs with correct production defaults: scope selection (CLOUDFRONT vs REGIONAL), managed rule groups (AWSManagedRulesCommonRuleSet, SQLiRuleSet, LinuxRuleSet, WindowsRuleSet, IPReputationList, BotControlRuleSet, AmazonIpReputationList, ATP), custom rules (byte match, IP set, regex pattern, geo match, size constraint, rate-based), rule priority ordering, logging destinations (Kinesis Firehose, CloudWatch Logs, S3), resource association (ALB, API Gateway, CloudFront), rate-based rules with aggregate keys (IP, forwarded IP), Challenge and CAPTCHA actions, and account takeover prevention. Emits a READY_TO_DEPLOY checklist. Use when creating a Web ACL, attaching managed rules, configuring rate limiting, enabling WAF logging, associating a Web ACL with an ALB/API Gateway/CloudFront, or configuring CAPTCHA/Challenge actions. Triggers: create WAF Web ACL, WAFv2, managed rule groups, WAF rate limiting, WAF logging, WAF CAPTCHA, WAF Challenge action, bot control, ATP managed rules.

★ 4
jhkchan
jhkchan/aws-agent-skills

wafv2-web-acl-auditor

Audits AWS WAFv2 Web ACL configurations to determine whether the ACL provides effective protection: default-action posture (Allow vs Block), managed-rule-group coverage gaps, rule effectiveness (BLOCK vs COUNT, shadow/bypass rules, stale exclusions), rate-based rule correctness, logging and visibility configuration, and text-transformation bypass vectors. Emits a deterministic verdict per Web ACL. Use when reviewing a WAFv2 Web ACL for security posture, checking managed-rule coverage, validating rate-limit configuration, auditing WAF logging, or hardening a WAF before production deployment. Triggers: WAF, WAFv2, Web ACL, managed rule group, AWSManagedRules, rate-based rule, CAPTCHA, Challenge, OverrideAction, Count mode, forwarded IP, Bot Control, ATP, text transformation, WAF logging, WAF visibility, OWASP, SQLi, XSS, RFI.

★ 4
jhkchan
jhkchan/aws-agent-skills

waf-rule-deployer

Provisions AWS WAFv2 rule sets with production defaults: Web ACL creation (CloudFront scope in us-east-1 vs Regional scope), rule groups (managed vs custom) with capacity planning in WCU (Web ACL Capacity Units, 1500 default per ACL), managed rule groups (AWSManagedRulesCommonRuleSet, AWSManagedRulesSQLiRuleSet, AWSManagedRulesAmazonIpReputationList, AWSManagedRulesLinuxRuleSet, AWSManagedRulesWindowsRuleSet, AWSManagedRulesUnixRuleSet), custom rules (byte-match, regex pattern set, geo-match, rate-based), IP set and regex pattern set resources, rule priority ordering (lowest number evaluated first), action types (allow, block, count, CAPTCHA, Challenge), bot control managed rule group, account takeover. Triggers: create WAF rule, WAF managed rule group, WAF custom rule, WAF byte match, WAF geo match, WAF rate based rule, WAF IP set, WAF regex pattern set, WAF WCU budget, WAF CloudFront ACL, WAF logging Kinesis Firehose, WAF bot control, WAF ATP, WAF label matching, WAF Challenge action, WAF CAPTCHA.

★ 4