菜单
Use when academy staff need to connect Slack, run manual syncs, and monitor Slack sync health for students/cohorts; do NOT use for generic notifications or non-Slack messaging workflows.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when building or operating a staff frontend to list, schedule, sync, or recover academy GitHub organization memberships; do NOT use for Copilot seats, provisioning bills, or staff/student invites unrelated to GitHub org membership.
Load first for academy-scoped BreatheCode API work (/academy/, Academy header, staff capabilities). Maps requests to domain skills. Do NOT use for pure learner self-service without staff context — use breathecode-student-api-index instead.
Use when academy staff need to list or view certificate specialties, create or update academy-owned specialties, link a syllabus to a specialty, or assign a specialty to a student by issuing a certificate; do NOT use for listing a student's own certificates (use certificate me endpoint).
Use when an authenticated student needs to check LLM budget entitlement, list LiteLLM API keys and per-key spend, create a new LLM API key, or delete an existing key; do NOT use for academy staff configuring LiteLLM vendors or teams, VPS provisioning, or granting LLM budget through plans.
Load first for authenticated learner BreatheCode API work (user-scoped /me and user/me routes, public join/catalog where applicable). Maps requests to domain skills. Do NOT use for academy admin tasks requiring /academy/ or the Academy header — use breathecode-staff-api-index instead.
Use when academy staff need to set main currency and create, list, update, or deprecate checkout payment methods; do NOT use for Stripe credential setup when is_credit_card is true (use bc-payments-configure-academy-stripe first), student card save, or subscription cancel/refund.
| name | bc-notify-manage-academy-slackintegration |
| description | Use when academy staff need to connect Slack, run manual syncs, and monitor Slack sync health for students/cohorts; do NOT use for generic notifications or non-Slack messaging workflows. |
| requires | [] |
Use this skill when the user asks to connect an academy to Slack using manual credentials, manually sync Slack users/channels, or inspect sync status/errors/last sync times. Use it for team-level and individual student/cohort sync actions. Do NOT use it for email/SMS notifications, webhook subscriptions, or unrelated admissions operations.
name_normalized matches the cohort slug.GET /v1/notify/slack/team and filter by academy if needed.POST /v1/notify/academy/slack/team/<team_id>/credentials with a Slack bot token and metadata (team_name, optional app_id, bot_user_id, authed_user).GET /v1/notify/academy/slack/team/<team_id>/credentials and confirm configured=true.POST /v1/notify/academy/slack/team/<team_id>/sync/usersPOST /v1/notify/academy/slack/team/<team_id>/sync/channelsPOST /v1/notify/academy/slack/team/<team_id>/sync/user/<slack_user_id>POST /v1/notify/academy/slack/team/<team_id>/sync/cohort/<cohort_id>GET /v1/notify/academy/slack/team/<team_id>/sync/statusGET /v1/notify/academy/slack/team/<team_id>/sync/user/<slack_user_id>GET /v1/notify/academy/slack/team/<team_id>/sync/cohort/<cohort_id>/v1/admissions/academy/cohort/user)/v1/admissions/academy/cohort).| Action | Method | Path | Headers | Body | Response |
|---|---|---|---|---|---|
| List linked Slack teams | GET | /v1/notify/slack/team | Authorization | Query optional: academy=<slug> | Paginated list of Slack teams |
| Get team credentials status | GET | /v1/notify/academy/slack/team/<team_id>/credentials | Authorization, Academy: <academy_id> | — | configured boolean + metadata; token is never returned |
| Configure team credentials | POST/PUT | /v1/notify/academy/slack/team/<team_id>/credentials | Authorization, Academy: <academy_id> | token, optional team_name, app_id, bot_user_id, authed_user | 200 configured response |
| Trigger team users sync | POST | /v1/notify/academy/slack/team/<team_id>/sync/users | Authorization, Academy: <academy_id> | — | 202 accepted + metadata |
| Trigger team channels sync | POST | /v1/notify/academy/slack/team/<team_id>/sync/channels | Authorization, Academy: <academy_id> | — | 202 accepted + metadata |
| Trigger single user sync | POST | /v1/notify/academy/slack/team/<team_id>/sync/user/<slack_user_id> | Authorization, Academy: <academy_id> | — | 202 accepted + metadata |
| Get single user sync status | GET | /v1/notify/academy/slack/team/<team_id>/sync/user/<slack_user_id> | Authorization, Academy: <academy_id> | — | User-team sync status object |
| Trigger single cohort sync | POST | /v1/notify/academy/slack/team/<team_id>/sync/cohort/<cohort_id> | Authorization, Academy: <academy_id> | — | 202 accepted + metadata |
| Get single cohort sync status | GET | /v1/notify/academy/slack/team/<team_id>/sync/cohort/<cohort_id> | Authorization, Academy: <academy_id> | — | Cohort-channel sync status object |
| Get team sync status | GET | /v1/notify/academy/slack/team/<team_id>/sync/status | Authorization, Academy: <academy_id> | — | Team summary + users/channels counters |
| Manage cohort membership (source data) | GET/POST/PUT/DELETE | /v1/admissions/academy/cohort/user | Authorization, Academy: <academy_id> | Depends on method | Cohort-user assignment result |
| Manage cohorts/slugs (source data) | GET/POST/PUT | /v1/admissions/academy/cohort | Authorization, Academy: <academy_id> | Depends on method | Cohort object(s) |
Configure team credentials — request (POST /v1/notify/academy/slack/team/<team_id>/credentials):
{
"token": "xoxb-1234567890-abcdef",
"team_name": "4Geeks Academy",
"app_id": "A123456",
"bot_user_id": "U0BOT123",
"authed_user": "U0ADMIN123"
}
Credentials status — response (200):
{
"configured": true,
"team_id": "T01ABC",
"team_name": "4Geeks Academy",
"app_id": "A123456",
"bot_user_id": "U0BOT123",
"authed_user": "U0ADMIN123",
"updated_at": "2026-03-23T18:21:31.123Z"
}
Trigger team users sync — response (202):
{
"status": "accepted",
"sync_type": "users",
"team_id": 7
}
Trigger single user sync — response (202):
{
"status": "accepted",
"sync_type": "user",
"team_id": 7,
"slack_user_id": "U09ABC123"
}
Team sync status — response (200):
{
"id": 7,
"slack_id": "T01ABC",
"name": "4Geeks Academy",
"sync_status": "COMPLETED",
"sync_message": null,
"synqued_at": "2026-03-23T18:21:31.123Z",
"users": {
"total": 120,
"completed": 110,
"incompleted": 10,
"last_synqued_at": "2026-03-23T18:21:30.555Z"
},
"channels": {
"total": 18,
"completed": 15,
"incompleted": 3,
"last_synqued_at": "2026-03-23T18:20:40.111Z"
}
}
Single user status — response (200):
{
"sync_status": "INCOMPLETED",
"sync_message": "Slack user exists but is not linked to this team",
"synqued_at": null
}
GET list note: GET /v1/notify/slack/team is paginated.
For /academy/ endpoints, always send Academy header. Error messages may be translated; send Accept-Language (en, es) to control language.
Academy header and permissions.slack-team-not-found. Use a team id that belongs to the current academy.GET /v1/notify/slack/team).POST /v1/notify/academy/slack/team/<team_id>/credentials.configured=true using GET /v1/notify/academy/slack/team/<team_id>/credentials.202 accepted responses.