AGENT SKILL

pm-gitlab

GitLab connector knowledge and safe action guide.

License 许可
AGPL-3.0
所属仓库
polymetrics-ai/cli
最近更新
2026-09-21
Stars
★ 7
Forks
0

01 前言 Front Matter

name
pm-gitlab
description
GitLab connector knowledge and safe action guide.

02 资源文件 1

03 SKILL.md 正文

pm-gitlab

Purpose

Reads GitLab projects, groups, users, and issues through existing GitLab REST API v4 ETL streams; its provider-owned ledger records the full published surface, but G1 declares no write command.

Icon

Capabilities

  • check=true catalog=true read=true write=false query=false
  • Integration type: api

Authentication

  • Use pm credentials add with --from-env or --value-stdin for secret fields.

Configuration

  • base_url
  • mode
  • page_size
  • start_date
  • access_token (secret) (required)

ETL Streams

  • projects:
    • primary key: id
    • cursor: last_activity_at
    • fields: archived(boolean), created_at(string), default_branch(string), description(string), forks_count(integer), id(integer), last_activity_at(string), name(string), open_issues_count(integer), path(string), path_with_namespace(string), star_count(integer), visibility(string), web_url(string)
  • groups:
    • primary key: id
    • cursor: created_at
    • fields: created_at(string), description(string), full_name(string), full_path(string), id(integer), name(string), parent_id(integer), path(string), visibility(string), web_url(string)
  • users:
    • primary key: id
    • cursor: created_at
    • fields: bot(boolean), created_at(string), id(integer), is_admin(boolean), name(string), state(string), username(string), web_url(string)
  • issues:
    • primary key: id
    • cursor: updated_at
    • fields: author_id(integer), closed_at(string), created_at(string), downvotes(integer), id(integer), iid(integer), project_id(integer), state(string), title(string), updated_at(string), upvotes(integer), user_notes_count(integer), web_url(string)

Sync Modes

  • ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped

Security

  • read risk: external GitLab API read of projects, groups, users, and issues
  • write risk: GitLab publishes mutation endpoints, but this G1 bundle declares no executable write actions.
  • approval: Any future GitLab write must use the standard plan, preview, explicit approval, and execute flow; no GitLab writes are executable in this wave.
  • Never pass secret values in chat, shell arguments, logs, docs, or JSON output.

Command Surface

  • Read the four existing GitLab ETL streams through typed commands.
  • Usage: pm gitlab <command> [flags]
  • Source CLI: GitLab REST API v4 (Official OpenAPI 3.0.0, info.version 19.3.0-pre, retrieved 2026-08-05)
  • Global flags:
    • --credential (string): Credential name to use for the GitLab request.
    • --connection (string): Alias for --credential.
    • --config (string_array): Connector config override as key=value; never pass secret values here.
    • --json (boolean): Emit machine-readable JSON output.
    • --limit (integer): Maximum records to emit from a stream command.
  • ETL streams
    • projects list - List GitLab projects as ETL records. [intent=etl availability=implemented stream=projects]
    • groups list - List GitLab groups as ETL records. [intent=etl availability=implemented stream=groups]
    • users list - List GitLab users as ETL records. [intent=etl availability=implemented stream=users]
    • issues list - List GitLab issues as ETL records. [intent=etl availability=implemented stream=issues]
  • Help topics:
    • authentication - Store GitLab access tokens with pm credentials; never pass secret values in command text.
    • operation-inventory - The provider-owned GitLab OpenAPI v3 ledger records all 1,745 callable operations; this wave exposes only the four existing stream reads.
    • known-limits - Of 1,745 inventoried operations, 4 are executable here; 1,618 need connector declarations, 45 need the multipart/file-upload foundation, 64 are provider-restricted, and 14 are deprecated exclusions.

Commands

Inspect as a manual

pm connectors inspect gitlab

Inspect as structured JSON

pm connectors inspect gitlab --json

Agent Rules

  • Run pm connectors inspect gitlab 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.

04 同仓库更多 Skills