tfccli
一个专为 Terraform Cloud/HCP Terraform 设计的命令行工具，支持AI代理调用。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：tfccli。 它的用途是：一个专为 Terraform Cloud/HCP Terraform 设计的命令行工具，支持AI代理调用。 完整的 Skill 内容见：https://321skill.com/skills/tfccli/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我使用tfccli在‘prod’上下文中，为‘frontend-app’项目创建一个新的Terraform Cloud工作空间，并设置自动触发运行。”，AI会生成相应的 `tfccli workspaces create` 命令及参数。或者，你可以说：“获取最近一次失败的运行计划详情并保存为JSON文件”，AI会指导你组合使用 `tfccli runs list` 和 `tfccli plans get --output-format json` 命令。
介绍
tfccli 是一个用于与 Terraform Cloud / HCP Terraform API 交互的命令行工具。它解决了开发者和运维人员在自动化流程中需要频繁操作Terraform Cloud资源（如组织、项目、工作空间、运行等）的痛点，无需依赖Web界面或编写复杂的API调用脚本。
该工具遵循Terraform CLI的认证规范，可直接复用 terraform login 生成的凭证，无需额外配置密钥。它支持多环境上下文管理，方便在不同TFC/TFE实例间切换，并且所有命令都提供一致的JSON输出，非常适合集成到CI/CD流水线或AI代理的自动化脚本中。
tfccli 非常适合后端开发、运维工程师、运维开发以及需要进行基础设施即代码（IaC）管理的项目经理使用。他们可以利用此工具批量管理资源、执行自动化部署、或将其作为内部工具链的一部分。
使用建议：初次使用时，建议先运行 tfccli doctor 验证配置。在自动化脚本中，务必使用 --force 和 --output-format json 标志来确保非交互式运行的稳定性和结果的可解析性。注意，其功能完全围绕Terraform Cloud API，不适用于本地Terraform状态管理。
核心特点
与通用Terraform CLI或纯API脚本相比，tfccli专为Terraform Cloud/HCP Terraform的API操作而深度优化，提供了完整的CRUD命令和资源下载功能；同时，它原生支持多上下文管理和自动化友好的JSON输出，使其成为连接人类操作与AI编码代理的理想桥梁。
注意事项
此工具仅适用于管理Terraform Cloud或HCP Terraform平台上的资源，不适用于操作本地Terraform状态或与其他云服务商API直接交互。
常见问题
tfccli如何认证？需要单独配置API Token吗？
不需要单独配置，它会自动发现并使用你通过 `terraform login` 命令或环境变量（如 TF_TOKEN_app_terraform_io）设置的Terraform Cloud API Token。
能否在CI/CD流水线中使用tfccli？
完全可以。通过 `--non-interactive`、`--force` 和 `--output-format json` 等参数，它可以无缝集成到自动化脚本和CI/CD流程中，执行如触发运行、获取计划详情等操作。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/tfccli/raw/index.md 读取 tfccli 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/tfccli/raw/index.md（查看排版版本）