AGENT SKILL
pm-circleci
CircleCI connector knowledge and safe action guide.
- License 许可
- AGPL-3.0
- 最近更新
- 2026-09-21
- Stars
- ★ 7
- Forks
- 0
01 前言 Front Matter
- name
- pm-circleci
- description
- CircleCI connector knowledge and safe action guide.
03 SKILL.md 正文
pm-circleci
Purpose
Reads and writes CircleCI projects, pipelines, workflows, jobs, contexts, schedules, environment variables, checkout keys, and workflow insights through the CircleCI v2 REST API.
Icon
- id: simple-icons-circleci
- asset: icons/simple-icons/circleci.svg
- title: CircleCI
- simple_icon_slug: circleci
- simple_icon_hex: 343434
- source: simple-icons
- license: CC0-1.0
- review_status: cc0_with_trademark_caveat
- review_url: https://simpleicons.org/?q=CircleCI
- match: exact-name-or-slug
- matched_by: circleci
Capabilities
- check=true catalog=true read=true write=true query=false
- Integration type: api
Authentication
- Use pm credentials add with --from-env or --value-stdin for secret fields.
Configuration
- base_url
- mode
- org
- pipeline_id
- repo
- vcs_type
- workflow_id
- api_key (secret) (required)
ETL Streams
- projects:
- primary key: id
- fields: default_branch(string), id(string), name(string), organization_id(string), organization_name(string), organization_slug(string), slug(string), vcs_url(string)
- pipelines:
- primary key: id
- cursor: created_at
- fields: created_at(string), id(string), number(integer), project_slug(string), state(string), updated_at(string)
- workflows:
- primary key: id
- cursor: created_at
- fields: created_at(string), id(string), name(string), pipeline_id(string), pipeline_number(integer), project_slug(string), status(string), stopped_at(string)
- jobs:
- primary key: id
- cursor: started_at
- fields: id(string), job_number(integer), name(string), project_slug(string), started_at(string), status(string), stopped_at(string), type(string)
- contexts:
- primary key: id
- fields: created_at(string), id(string), name(string)
- schedules:
- primary key: id
- cursor: updated-at
- fields: actor(object), created-at(string), description(string), id(string), name(string), parameters(object), project-slug(string), timetable(object), updated-at(string)
- checkout_keys:
- primary key: fingerprint
- fields: created-at(string), fingerprint(string), preferred(boolean), public-key(string), type(string)
- environment_variables:
- primary key: name
- fields: created-at(string), name(string), value(string)
- insights_workflow_summary:
- primary key: name
- fields: metrics(object), name(string), project_id(string), window_end(string), window_start(string)
Sync Modes
- ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped, incremental_append, incremental_append_deduped
Reverse ETL Actions
- create_schedule:
- endpoint: POST /project/{{ config.vcs_type }}/{{ config.org }}/{{ config.repo }}/schedule
- required fields: name, timetable, attribution-actor, parameters
- risk: external mutation; creates a new scheduled-pipeline trigger for this project
- update_schedule:
- endpoint: PATCH /schedule/{{ record.id }}
- required fields: id
- risk: external mutation; updates an existing scheduled-pipeline trigger's timetable or parameters
- delete_schedule:
- endpoint: DELETE /schedule/{{ record.id }}
- required fields: id
- risk: irreversible external deletion of a scheduled-pipeline trigger; approval required
- create_environment_variable:
- endpoint: POST /project/{{ config.vcs_type }}/{{ config.org }}/{{ config.repo }}/envvar
- required fields: name, value
- risk: external mutation; creates or overwrites a project environment variable used by every future CI run
- delete_environment_variable:
- endpoint: DELETE /project/{{ config.vcs_type }}/{{ config.org }}/{{ config.repo }}/envvar/{{ record.name }}
- required fields: name
- risk: irreversible external deletion of a project environment variable; may break future CI runs that depend on it; approval required
- create_checkout_key:
- endpoint: POST /project/{{ config.vcs_type }}/{{ config.org }}/{{ config.repo }}/checkout-key
- required fields: type
- risk: external mutation; creates a new deploy/checkout SSH key with repository access
- delete_checkout_key:
- endpoint: DELETE /project/{{ config.vcs_type }}/{{ config.org }}/{{ config.repo }}/checkout-key/{{ record.fingerprint }}
- required fields: fingerprint
- risk: irreversible external revocation of a deploy/checkout SSH key; may break future CI checkouts that depend on it; approval required
Security
- read risk: external CircleCI API read of CI project, pipeline, workflow, job, context, schedule, environment-variable, checkout-key, and workflow-insight metadata
- write risk: external mutation of CircleCI project configuration: schedule/environment-variable/checkout-key create and delete; never triggers, cancels, or approves a live CI run
- Never pass secret values in chat, shell arguments, logs, docs, or JSON output.
Commands
Inspect as a manual
pm connectors inspect circleci
Inspect as structured JSON
pm connectors inspect circleci --json
Agent Rules
- Run pm connectors inspect circleci before creating credentials or plans.
- Use --json only when the caller needs structured output; use the manual for human-readable guidance.
- Never ask the user to paste secret values into chat.
- For reverse ETL writes, create a plan, show the preview, wait for explicit approval, then run with the approval token.
04 同仓库更多 Skills
recipe-preview-approve-reverse-etl
Preview and approve a reverse ETL plan safely.
★ 7
recipe-github-prs-to-warehouse
Sync GitHub pull requests into the local warehouse.
★ 7
pm-zoom
Zoom connector knowledge and safe action guide.
★ 7
pm-zonka-feedback
Zonka Feedback connector knowledge and safe action guide.
★ 7
pm-zoho-invoice
Zoho Invoice connector knowledge and safe action guide.
★ 7
pm-zoho-inventory
Zoho Inventory connector knowledge and safe action guide.
★ 7