Merge pull request #236 from flashcatcloud/docs/cli-agent-skill

docs(cli): reflect the single consolidated flashduty agent skill

Author: ysyneu

en/developer/cli.mdx

@@ -505,28 +505,15 @@ When a projected structured output exceeds its limit, the CLI keeps the selected
 
 ## Agent skills
 
-Flashduty CLI ships with 10 agent skills that teach AI coding agents — Claude Code, Cursor, Codex, Gemini CLI, Windsurf, and 40+ others — how to operate Flashduty from your terminal.
+Flashduty CLI ships with a single agent skill named `flashduty` that teaches AI coding agents — Claude Code, Cursor, Codex, Gemini CLI, Windsurf, and 40+ others — how to operate Flashduty from your terminal.
 
-Install skills to every detected agent on your machine in one shot:
+Install it to every detected agent on your machine in one shot:
 
 ```bash
 npx skills add flashcatcloud/flashduty-cli -y -g
 ```
 
-Available skills:
-
-| Skill | Scope |
-|-------|-------|
-| `flashduty-shared` | Foundation: authentication, three-layer noise model, global flags, safety rules |
-| `flashduty-incident` | Incident lifecycle: triage, investigate, resolve, merge, snooze, reassign |
-| `flashduty-alert` | Alert and alert event investigation: drill down, trace, merge |
-| `flashduty-change` | Change event tracking and deployment frequency trends |
-| `flashduty-oncall` | On-call schedule queries: who is on call, shift details |
-| `flashduty-channel` | Channel and escalation rule lookups |
-| `flashduty-statuspage` | Status page management and Atlassian → Flashduty migration |
-| `flashduty-insight` | Analytics: MTTA/MTTR, noise reduction, notification trends |
-| `flashduty-admin` | Team/member lookups and audit log search |
-| `flashduty-template` | Notification template validation and preview |
+The skill uses a router-plus-reference-card structure: `SKILL.md` carries the shared conventions (authentication, global flags, safety rules) and indexes per-domain reference cards — incidents, alerts, changes, on-call and schedules, channels and escalations, status pages, insights, monitors, RUM and sourcemaps, automations, notification templates, members and teams, and more. Before running a task, the agent reads the card for that domain to get every command, flag, and workflow for it — no `--help` trial-and-error.
 
 ## Common workflows
 

en/developer/overview.mdx

@@ -13,7 +13,7 @@ Flashduty provides multiple developer tools to help you programmatically manage
 </Card>
 
 <Card title="Command-line tool" icon="terminal" href="/en/developer/cli">
-  Flashduty CLI for managing incidents, on-call schedules, status pages, and notification templates from your terminal — runs on macOS, Linux, and Windows with 10 built-in AI coding-agent skills.
+  Flashduty CLI for managing incidents, on-call schedules, status pages, and notification templates from your terminal — runs on macOS, Linux, and Windows with a built-in AI coding-agent skill.
 </Card>
 
 <Card title="Go SDK" icon="golang" href="/en/developer/go-sdk">
@@ -44,7 +44,7 @@ Visit the [API documentation](/en/openapi/introduction) for complete endpoint re
 
 ## Command-line tool
 
-Flashduty CLI (`flashduty`) is a command-line tool for managing the incident lifecycle, querying on-call schedules, publishing status pages, and debugging notification templates from your terminal. Its commands now cover the entire Flashduty OpenAPI. It runs on macOS, Linux, and Windows, and ships with 10 agent skills so it plugs directly into AI coding agents like Claude Code, Cursor, Codex, and Gemini CLI.
+Flashduty CLI (`flashduty`) is a command-line tool for managing the incident lifecycle, querying on-call schedules, publishing status pages, and debugging notification templates from your terminal. Its commands now cover the entire Flashduty OpenAPI. It runs on macOS, Linux, and Windows, and ships with a built-in agent skill so it plugs directly into AI coding agents like Claude Code, Cursor, Codex, and Gemini CLI.
 
 Install with one command:
 

zh/developer/cli.mdx

@@ -505,28 +505,15 @@ flashduty incident list --json --fields incident_id,title,progress
 
 ## Agent Skills
 
-Flashduty CLI 内置 10 个 Agent Skills，可让 Claude Code、Cursor、Codex、Gemini CLI、Windsurf 等 AI 编程代理通过 CLI 操作 Flashduty。
+Flashduty CLI 内置一个名为 `flashduty` 的 Agent Skill，可让 Claude Code、Cursor、Codex、Gemini CLI、Windsurf 等 AI 编程代理通过 CLI 操作 Flashduty。
 
 一键安装到当前机器上检测到的所有代理：
 
 ```bash
 npx skills add flashcatcloud/flashduty-cli -y -g
 ```
 
-可用技能列表：
-
-| 技能 | 覆盖范围 |
-|------|----------|
-| `flashduty-shared` | 基础：认证、三层降噪模型、全局参数、安全规则 |
-| `flashduty-incident` | 故障生命周期：分诊、调查、解决、合并、暂停、转派 |
-| `flashduty-alert` | 告警与告警事件调查：下钻、追踪、合并 |
-| `flashduty-change` | 变更事件追踪与部署频率趋势 |
-| `flashduty-oncall` | 值班查询：当前值班人、排班详情 |
-| `flashduty-channel` | 协作空间与分派策略查询 |
-| `flashduty-statuspage` | 状态页管理以及从 Atlassian 迁移到 Flashduty |
-| `flashduty-insight` | 分析：MTTA/MTTR、降噪率、通知趋势 |
-| `flashduty-admin` | 团队/成员查询与审计日志搜索 |
-| `flashduty-template` | 通知模板验证与预览 |
+技能采用「路由 + 参考卡」结构：`SKILL.md` 承载认证、全局参数、安全规则等共享约定，并按领域索引参考卡——故障、告警、变更、值班与排班、协作空间与分派、状态页、洞察、监控、RUM 与 sourcemap、自动化、通知模板、成员与团队等。代理执行任务前先读取对应领域的参考卡，即可获得该领域的全部命令、参数与工作流，无需 `--help` 试探。
 
 ## 常见用法
 

zh/developer/overview.mdx

@@ -13,7 +13,7 @@ Flashduty 提供多种开发者工具，帮助您以编程方式管理故障响
 </Card>
 
 <Card title="命令行工具" icon="terminal" href="/zh/developer/cli">
-  Flashduty CLI，在终端中管理故障、值班、状态页和通知模板，覆盖 macOS、Linux 和 Windows，并内置 10 个 AI 编程代理技能。
+  Flashduty CLI，在终端中管理故障、值班、状态页和通知模板，覆盖 macOS、Linux 和 Windows，并内置 AI 编程代理技能。
 </Card>
 
 <Card title="Go SDK" icon="golang" href="/zh/developer/go-sdk">
@@ -44,7 +44,7 @@ Flashduty Open API 采用 RESTful 风格，支持通过 APP Key 进行身份验
 
 ## 命令行工具
 
-Flashduty CLI（`flashduty`）是一款命令行工具，可在终端中完成故障生命周期管理、值班查询、状态页发布和通知模板调试。CLI 已实现对 Flashduty OpenAPI 的全量命令覆盖。支持 macOS、Linux 和 Windows，并内置 10 个 Agent Skills，可与 Claude Code、Cursor、Codex、Gemini CLI 等 AI 编程代理协同工作。
+Flashduty CLI（`flashduty`）是一款命令行工具，可在终端中完成故障生命周期管理、值班查询、状态页发布和通知模板调试。CLI 已实现对 Flashduty OpenAPI 的全量命令覆盖。支持 macOS、Linux 和 Windows，并内置 Agent Skill，可与 Claude Code、Cursor、Codex、Gemini CLI 等 AI 编程代理协同工作。
 
 一行命令安装：