# Env Discovery

> >

- **Type:** Skill
- **Install:** `agentstack add skill-aws-samples-sample-aws-ops-skills-for-agents-env-discovery`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [aws-samples](https://agentstack.voostack.com/s/aws-samples)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT-0
- **Upstream author:** [aws-samples](https://github.com/aws-samples)
- **Source:** https://github.com/aws-samples/sample-aws-ops-skills-for-agents/tree/main/env-discovery

## Install

```sh
agentstack add skill-aws-samples-sample-aws-ops-skills-for-agents-env-discovery
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Environment Discovery — Fleet Intelligence

通过 tag 导航发现环境结构，不枚举单个资源。

## 工作流程

### 1. 确认扫描目标
- 确认 account ID（默认 ``，从 environment.md 读取）
- 确认 region 范围（默认扫描 environment.md 中列出的所有 region）

### 2. 执行扫描
- 运行 `scripts/discover-account.sh  `
- 脚本三阶段独立执行：tag 发现 → 资源聚合 → 告警状态
- 输出 JSON 到 stdout，同时更新 environments/ 下的 account.yaml 和 account.md

### 3. 终端摘要输出
- 解析脚本输出的 JSON，渲染终端摘要
- 包含：各服务资源数量、当前告警、异常标记
- **报告中每条结论必须能追溯到本次扫描的 JSON 数据**，禁止从 account.yaml 旧注释、历史报告、或记忆中搬运未验证信息

### 3.1 与上次扫描对比（可选）
- 读 account.yaml 获取上次 service_catalog，与本次 JSON 做 diff
- 对比范围仅限于**本脚本覆盖的三个 phase**（tag / 资源聚合 / 告警）
- account.yaml 中的注释、log_sources 等**不在脚本扫描范围内**的信息，不得作为对比结论引用——如需报告这些信息，必须单独查询验证
- 发现变化时标注「新增 / 消失 / 数量变化」，附具体数据

### 4. 两种查询模式

#### 模式 1：全局概览（"环境怎么样"）
1. 读 environments//account.yaml 获取 service catalog
2. 查 CloudWatch Alarms in ALARM state → 按 alarm_prefix 归类到服务
3. 输出：各服务健康摘要 + 异常告警

#### 模式 2：定向下钻（"交易引擎的 DB 怎么样"）
1. 从 service catalog 找到 tag 和 resource_types
2. 用 tag 过滤查询目标资源的 CloudWatch 指标
   - RDS: CPUUtilization, FreeableMemory, ReplicaLag
   - EC2: CPUUtilization, StatusCheckFailed
   - EKS: pod restart count, node status
3. 只返回指标异常或用户关心的资源详情

## 查询参考
各服务具体的 AWS CLI 命令和解读要点见 `references/service-checklist.md`。
不要自行编写查询命令——用 checklist 中验证过的命令。

## Automation Boundary

### auto-safe
- 所有 describe / list / get 查询
- resourcegroupstaggingapi 调用
- cloudwatch describe-alarms
- 生成报告文件

### human-required
- 无（本 skill 纯只读）

## Gotchas
- `resourcegroupstaggingapi` 返回的 ARN 中 `ec2` 涵盖 instance/vpc/subnet/sg/nat/igw 等所有资源。必须从 ARN 第 6 段提取细分类型（如 `ec2:instance`），否则会误报"19 台 EC2"实际是网络资源
- Tag 推断 primary_key 时需排除 k8s 系统 tag（key 含 `.` 或 `/` 的，如 `alpha.eksctl.io/xxx`）
- 个人/实验账号可能没有业务级 tag（如 `service`），`Project` 或 `Name` 可能是最接近的替代
- **account.yaml 中的历史注释不是实时数据**。脚本只产出 tag/资源聚合/告警三类数据，account.yaml 中的 `log_sources`、手写注释等是其他流程或人工维护的。巡检报告不得把这些当作本次扫描结论。引用前必须用 CLI 验证当前状态
- **扫描后清理 account.yaml 中的过期注释**。已解决的问题标注解决时间，未验证的问题不要留着——下次扫描会误导

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [aws-samples](https://github.com/aws-samples)
- **Source:** [aws-samples/sample-aws-ops-skills-for-agents](https://github.com/aws-samples/sample-aws-ops-skills-for-agents)
- **License:** MIT-0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-aws-samples-sample-aws-ops-skills-for-agents-env-discovery
- Seller: https://agentstack.voostack.com/s/aws-samples
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.