AGENT SKILL
pm-devin-ai
Devin AI connector knowledge and safe action guide.
- License 许可
- AGPL-3.0
- 最近更新
- 2026-09-21
- Stars
- ★ 7
- Forks
- 0
01 前言 Front Matter
- name
- pm-devin-ai
- description
- Devin AI connector knowledge and safe action guide.
02 资源文件 1
- 参考文档MANUAL.md12.9 KB
03 SKILL.md 正文
pm-devin-ai
Purpose
Reads Devin AI sessions, session child resources, playbooks, knowledge notes, repositories, schedules, membership, metrics, consumption, and secret metadata through the Devin v3 REST API; writes documented organization-scoped JSON mutations.
Icon
- id: devin-ai
- asset: icons/devin-ai.svg
- source: upstream_registry
- review_status: upstream_seeded
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
- metrics_time_after
- metrics_time_before
- mode
- org_id (required)
- page_size
- repository_filter_name
- start_date
- user_email
- api_token (secret) (required)
ETL Streams
- sessions:
- primary key: session_id
- cursor: created_at
- fields: acus_consumed(number), category(string), child_session_ids(array), created_at(integer), is_archived(boolean), org_id(string), origin(string), parent_session_id(string), playbook_id(string), pull_requests(array), service_user_id(string), session_id(string), status(string), status_detail(string), structured_output(object), subcategory(string), tags(array), title(string), updated_at(integer), url(string), user_id(string)
- sessions_insights:
- primary key: session_id
- cursor: created_at
- fields: acus_consumed(number), analysis(object), category(string), created_at(integer), is_archived(boolean), message_count(integer), num_devin_messages(integer), num_user_messages(integer), org_id(string), origin(string), playbook_id(string), pull_requests(array), service_user_id(string), session_id(string), session_size(string), status(string), status_detail(string), subcategory(string), summary(string), tags(array), title(string), updated_at(integer), url(string), user_id(string)
- session_details:
- primary key: session_id
- cursor: created_at
- fields: acus_consumed(number), category(string), child_session_ids(array), created_at(integer), is_archived(boolean), org_id(string), origin(string), parent_session_id(string), playbook_id(string), pull_requests(array), service_user_id(string), session_id(string), status(string), status_detail(string), structured_output(object), subcategory(string), tags(array), title(string), updated_at(integer), url(string), user_id(string)
- session_messages:
- primary key: message_id
- cursor: created_at
- fields: content(string), created_at(integer), event_id(string), message(string), message_id(string), role(string), session_id(string), source(string), type(string)
- session_attachments:
- primary key: attachment_id
- fields: attachment_id(string), content_type(string), name(string), session_id(string), source(string), url(string)
- session_tags:
- primary key: session_id
- fields: session_id(string), tags(array)
- playbooks:
- primary key: playbook_id
- fields: access_type(string), body(string), created_at(integer), created_by(string), description(string), macro(string), name(string), org_id(string), playbook_id(string), structured_output_schema(object), title(string), updated_at(integer), updated_by(string)
- secrets:
- primary key: secret_id
- fields: access_type(string), created_at(integer), created_by(string), is_sensitive(boolean), key(string), name(string), note(string), secret_id(string), secret_type(string), type(string), updated_at(integer), updated_by(string)
- knowledge_notes:
- primary key: note_id
- fields: access_type(string), body(string), created_at(integer), folder_id(string), folder_path(string), is_enabled(boolean), macro(string), name(string), note_id(string), org_id(string), pinned_repo(string), trigger(string), updated_at(integer)
- knowledge_folders:
- primary key: folder_id
- fields: folder_id(string), name(string), note_count(integer), parent_folder_id(string), path(string)
- repositories:
- primary key: repo_path
- fields: git_connection_host(string), git_connection_id(string), indexing_status(object), last_updated_at(integer), provider_repository_id(string), repo_description(string), repo_language(string), repo_name(string), repo_path(string)
- indexed_repositories:
- primary key: repository_path
- fields: branches(array), indexing_enabled(boolean), indexing_status(object), repository_path(string)
- schedules:
- primary key: scheduled_session_id
- fields: agent(string), bypass_approval(boolean), consecutive_failures(integer), created_at(string), created_by(string), enabled(boolean), frequency(string), interval_count(integer), last_edited_by(string), last_error_at(string), last_error_message(string), last_executed_at(string), name(string), notify_on(string), org_id(string), platform(string), playbook(object), prompt(string), schedule_type(string), scheduled_at(string), scheduled_session_id(string), tags(array), target_devin_id(string), updated_at(string)
- organization_users:
- primary key: user_id
- fields: email(string), name(string), role_assignments(array), user_id(string)
- organization_idp_group_users:
- primary key: user_id
- fields: email(string), idp_role_assignments(array), name(string), user_id(string)
- self:
- primary key: principal_type
- fields: api_key_id(string), api_key_name(string), creator_service_user_id(string), devin_id(string), org_id(string), principal_type(string), service_user_id(string), service_user_name(string), user_id(string), user_name(string)
- org_daily_consumption:
- primary key: metric
- fields: metric(string), session_id(string), user_id(string)
- session_daily_consumption:
- primary key: metric
- fields: metric(string), session_id(string), user_id(string)
- user_daily_consumption:
- primary key: metric
- fields: metric(string), session_id(string), user_id(string)
- org_usage_metrics:
- primary key: metric
- fields: metric(string), session_id(string), user_id(string)
- org_session_metrics:
- primary key: metric
- fields: metric(string), session_id(string), user_id(string)
- org_active_users_metrics:
- primary key: metric
- fields: metric(string), session_id(string), user_id(string)
- org_daily_active_users:
- primary key: metric
- fields: metric(string), session_id(string), user_id(string)
- org_monthly_active_users:
- primary key: metric
- fields: metric(string), session_id(string), user_id(string)
- org_pr_metrics:
- primary key: metric
- fields: metric(string), session_id(string), user_id(string)
- org_search_metrics:
- primary key: metric
- fields: metric(string), session_id(string), user_id(string)
- org_weekly_active_users:
- primary key: metric
- fields: metric(string), session_id(string), user_id(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_session:
- endpoint: POST /v3/organizations/{{ config.org_id }}/sessions
- required fields: prompt
- risk: creates a new Devin session in the organization and can consume ACUs
- send_session_message:
- endpoint: POST /v3/organizations/{{ config.org_id }}/sessions/{{ record.devin_id }}/messages
- required fields: devin_id, message
- risk: sends a message to an active or suspended Devin session and may resume work
- append_session_tags:
- endpoint: POST /v3/organizations/{{ config.org_id }}/sessions/{{ record.devin_id }}/tags
- required fields: devin_id, tags
- risk: adds tags to a Devin session
- replace_session_tags:
- endpoint: PUT /v3/organizations/{{ config.org_id }}/sessions/{{ record.devin_id }}/tags
- required fields: devin_id, tags
- risk: replaces all tags on a Devin session
- archive_session:
- endpoint: POST /v3/organizations/{{ config.org_id }}/sessions/{{ record.devin_id }}/archive
- required fields: devin_id
- risk: archives a Devin session and puts it to sleep if currently running
- terminate_session:
- endpoint: DELETE /v3/organizations/{{ config.org_id }}/sessions/{{ record.devin_id }}
- required fields: devin_id
- risk: terminates a Devin session
- generate_session_insights:
- endpoint: POST /v3/organizations/{{ config.org_id }}/sessions/{{ record.devin_id }}/insights/generate
- required fields: devin_id
- risk: triggers on-demand generation of session insights
- create_schedule:
- endpoint: POST /v3/organizations/{{ config.org_id }}/schedules
- required fields: name, prompt
- risk: creates a scheduled Devin session that can run automatically
- update_schedule:
- endpoint: PATCH /v3/organizations/{{ config.org_id }}/schedules/{{ record.schedule_id }}
- required fields: schedule_id
- risk: updates an existing scheduled Devin session
- delete_schedule:
- endpoint: DELETE /v3/organizations/{{ config.org_id }}/schedules/{{ record.schedule_id }}
- required fields: schedule_id
- risk: soft-deletes a schedule
- create_playbook:
- endpoint: POST /v3/organizations/{{ config.org_id }}/playbooks
- required fields: title, body
- risk: creates an organization-level Devin playbook
- update_playbook:
- endpoint: PUT /v3/organizations/{{ config.org_id }}/playbooks/{{ record.playbook_id }}
- required fields: playbook_id, title, body
- risk: replaces an organization-level Devin playbook
- delete_playbook:
- endpoint: DELETE /v3/organizations/{{ config.org_id }}/playbooks/{{ record.playbook_id }}
- required fields: playbook_id
- risk: deletes an organization-level Devin playbook
- create_knowledge_note:
- endpoint: POST /v3/organizations/{{ config.org_id }}/knowledge/notes
- required fields: name, body
- risk: creates an organization-level Devin knowledge note
- update_knowledge_note:
- endpoint: PUT /v3/organizations/{{ config.org_id }}/knowledge/notes/{{ record.note_id }}
- required fields: note_id, name, body
- risk: replaces an organization-level Devin knowledge note
- delete_knowledge_note:
- endpoint: DELETE /v3/organizations/{{ config.org_id }}/knowledge/notes/{{ record.note_id }}
- required fields: note_id
- risk: deletes an organization-level Devin knowledge note
- index_repository:
- endpoint: PUT /v3beta1/organizations/{{ config.org_id }}/repositories/{{ record.encoded_repository_path }}/indexing
- required fields: encoded_repository_path
- risk: enables indexing for a repository and can trigger indexing jobs
- bulk_index_repositories:
- endpoint: PUT /v3beta1/organizations/{{ config.org_id }}/repositories/indexing
- required fields: repositories
- risk: enables indexing for multiple repositories and can trigger indexing jobs
- remove_repository_indexing:
- endpoint: DELETE /v3beta1/organizations/{{ config.org_id }}/repositories/{{ record.encoded_repository_path }}/indexing
- required fields: encoded_repository_path
- risk: disables indexing and clears configured branches for a repository
- bulk_remove_repository_indexing:
- endpoint: DELETE /v3beta1/organizations/{{ config.org_id }}/repositories/indexing
- required fields: repository_paths
- risk: disables indexing and clears configured branches for multiple repositories
- remove_repository_branch_indexing:
- endpoint: DELETE /v3beta1/organizations/{{ config.org_id }}/repositories/{{ record.encoded_repository_path }}/indexing/branches/{{ record.encoded_branch_name }}
- required fields: encoded_repository_path, encoded_branch_name
- risk: removes one branch from repository indexing and can disable indexing if no branches remain
- trigger_pr_review:
- endpoint: POST /v3/organizations/{{ config.org_id }}/pr-reviews
- required fields: pr_url
- risk: triggers a Devin Review for a pull or merge request
- delete_secret:
- endpoint: DELETE /v3/organizations/{{ config.org_id }}/secrets/{{ record.secret_id }}
- required fields: secret_id
- risk: deletes Devin secret metadata and its stored value from the organization
Security
- read risk: external Devin AI API reads of organization-scoped sessions, context, repositories, schedules, membership, usage, and metadata
- write risk: creates or mutates Devin sessions, session tags/messages, schedules, playbooks, knowledge notes, repository indexing state, and PR reviews; destructive actions can terminate sessions or delete objects
- approval: reverse ETL writes require plan preview and approval token
- Never pass secret values in chat, shell arguments, logs, docs, or JSON output.
Commands
Inspect as a manual
pm connectors inspect devin-ai
Inspect as structured JSON
pm connectors inspect devin-ai --json
Agent Rules
- Run pm connectors inspect devin-ai 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