AgentSkillsCN

platform-setup

设置 Harness 平台账户基线。可创建账户级别的角色(共享资源访问权限)、管理员用户组,以及 OPA 治理策略(模板版本控制、API 令牌有效期强制执行)。适用于希望初始化 Harness 账户、搭建平台基础,或配置账户级别的治理时使用。

SKILL.md
--- frontmatter
name: platform-setup
description: "Set up the Harness Platform account baseline. Creates account-level roles (Shared Resource Access), admin user groups, and OPA governance policies (template versioning, API token age enforcement). Use when someone wants to initialize their Harness account, set up the platform foundation, or configure account-level governance."
allowed-tools:
  - Bash
  - Read
  - Write
  - Glob
  - Grep

Platform Setup

Set up the Harness Platform account baseline using the harness-platform-setup module.

Module directory: harness-platform-setup/

$ARGUMENTS

What This Creates

  • Shared Resource Access role — grants access to account-level shared resources
  • Harness Account Admins user group with account_admin role binding
  • All Account Users group updated with Shared Resource Access role binding
  • OPA Governance Policies:
    • Enforce Template Version Schema (templates must use v{number} versioning)
    • Enforce Harness API Token Age (30-day maximum age)

Required Inputs

InputRequiredDescription
Harness Account IDYesYour Harness account identifier
Platform URLNoDefaults to https://app.harness.io/gateway for SaaS
TagsNoCustom resource tags

Steps

  1. Auto-detect the account ID from HARNESS_ACCOUNT_ID env var. If not set, ask the user.

  2. Ask:

    • Are you using Harness SaaS (app.harness.io) or a self-managed instance?
    • Any custom tags to add to resources? (optional)
  3. Generate terraform.tfvars in harness-platform-setup/ with the collected values.

  4. Ensure providers.tf exists — copy from providers.tf.example at repo root if missing.

  5. Run tofu init in the module directory.

  6. Run tofu plan and present results in plain language:

    • "This will create X roles, Y user groups, and Z OPA governance policies at the account level."
  7. Ask for confirmation, then run tofu apply -auto-approve -var-file=terraform.tfvars.

  8. Show results and next steps:

    • "Account baseline is configured. Next, create an organization with /harness-factory:org-setup."

Prerequisites

  • None — this is the first module in the dependency chain