AGENT SKILL
pm-gitlab
GitLab connector knowledge and safe action guide.
- License 许可
- AGPL-3.0
- 最近更新
- 2026-09-21
- Stars
- ★ 7
- Forks
- 0
01 前言 Front Matter
- name
- pm-gitlab
- description
- GitLab connector knowledge and safe action guide.
02 资源文件 1
- 参考文档MANUAL.md4.5 KB
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
- id: gitlab
- asset: icons/gitlab.svg
- source: upstream_registry
- review_status: upstream_seeded
- review_url: https://docs.gitlab.com/ee/api/rest/deprecations.html
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
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