{
  "schemaVersion": 1,
  "skill": "analyze-grade-distribution-aa",
  "actions": [
    {
      "id": "health",
      "label": "运行检查",
      "description": "检查技能运行环境、教务系统 API 连通性、历史成绩库完整性。",
      "placements": ["skill-detail", "agent"],
      "executionProfile": "sync",
      "entrypoint": {
        "type": "cli",
        "command": "health",
        "args": []
      }
    },
    {
      "id": "version",
      "label": "查看版本",
      "description": "返回技能版本和机器标识。",
      "placements": ["skill-detail"],
      "executionProfile": "sync",
      "entrypoint": {
        "type": "cli",
        "command": "version",
        "args": []
      }
    },
    {
      "id": "config-path",
      "label": "查看配置位置",
      "description": "返回技能配置文件位置。",
      "placements": ["skill-detail"],
      "executionProfile": "sync",
      "entrypoint": {
        "type": "cli",
        "command": "config-path",
        "args": []
      }
    },
    {
      "id": "analyze-grade-distribution",
      "label": "分析这份成绩",
      "description": "对指定课程的成绩执行统计指标计算 + 三种异常模式识别 + AI 三段式评语生成，10~30 秒内返回报告。",
      "placements": ["row", "agent"],
      "executionProfile": "sync",
      "bind": {
        "tables": ["课程成绩"],
        "selectionMode": "required",
        "labelColumn": "课程名称"
      },
      "entrypoint": {
        "type": "cli",
        "command": "analyze-grade-distribution",
        "args": ["--course-id", "{row.课程ID}"]
      }
    },
    {
      "id": "batch-analyze-courses",
      "label": "批量分析本学期",
      "description": "批量分析某学期所有课程的成绩，按顺序逐门执行并汇总结果。",
      "placements": ["toolbar", "agent"],
      "executionProfile": "async",
      "bind": {
        "tables": ["课程成绩"]
      },
      "entrypoint": {
        "type": "cli",
        "command": "batch-analyze-courses",
        "args": ["--semester-id", "{form.semester_id}"]
      }
    },
    {
      "id": "render-html",
      "label": "查看分析报告",
      "description": "渲染指定分析报告的 HTML 页面，宿主 iframe 预览。",
      "placements": ["row", "skill-detail", "agent"],
      "executionProfile": "sync",
      "bind": {
        "tables": ["分析报告"],
        "selectionMode": "required",
        "labelColumn": "课程名称"
      },
      "entrypoint": {
        "type": "cli",
        "command": "render-html",
        "args": ["--report-id", "{row.报告ID}"]
      }
    },
    {
      "id": "flag-high-risk-course",
      "label": "标记为高风险课程",
      "description": "手动将某门课程标记为高风险课程，推送通知给教学督导与学院教学副院长。",
      "placements": ["row"],
      "executionProfile": "sync",
      "bind": {
        "tables": ["分析报告"],
        "selectionMode": "required",
        "labelColumn": "课程名称"
      },
      "entrypoint": {
        "type": "cli",
        "command": "flag-high-risk-course",
        "args": ["--report-id", "{row.报告ID}"]
      }
    },
    {
      "id": "sync-historical-grades",
      "label": "同步历史成绩",
      "description": "从教务系统重新拉取历史成绩数据。占位 Action，cron 启用后由定时调度。",
      "placements": ["cron", "agent", "toolbar"],
      "executionProfile": "async",
      "bind": {
        "tables": ["历史成绩"]
      },
      "entrypoint": {
        "type": "cli",
        "command": "sync-historical-grades",
        "args": []
      }
    }
  ]
}