Skill 资源分类与落库规划
按内容类型分类，不按来源分类。
定义依据（2026-02-12）
以下分类参考了最新公开规范与生态实践：
- Agent Skills 规范：
SKILL.md必需，scripts/、references/、assets/可选
参考：Agent Skills Specification - OpenAI Codex Skills：强调
SKILL.md + scripts/references/assets与 progressive disclosure
参考：OpenAI Codex Skills - MCP 原语：
tools（模型调用）、resources（应用控制）、prompts（用户选择）
参考：MCP Tools | MCP Resources | MCP Prompts
一、Skill 资源分类（统一口径）
1) 按 Skill 包内资源分类（文件结构）
| 分类 | 必选/可选 | 作用 | 你站点对应内容 |
|---|---|---|---|
SKILL.md | 必选 | 任务说明、触发描述、执行步骤 | 规则正文（可复制） |
scripts/ | 可选 | 可执行脚本，降低重复手工实现 | 规则生成器、校验脚本（规划） |
references/ | 可选 | 按需加载的领域参考资料 | 行业规则说明、字段字典（规划） |
assets/ | 可选 | 输出使用的模板/静态资源 | UI 模板、报表模板（规划） |
agents/openai.yaml | 可选 | UI 展示元数据、依赖声明 | 技能卡片增强信息（规划） |
2) 按运行控制方式分类（MCP 语义）
| 分类 | 控制方 | 典型用途 |
|---|---|---|
tools | 模型可调用 | 执行动作、调外部 API、自动化处理 |
resources | 应用控制 | 提供上下文数据（文件、日志、配置、字典） |
prompts | 用户选择 | 标准化任务入口与模板化工作流 |
3) 按你项目对外展示分类（内容分类）
| 分类 | 当前状态 | 说明 |
|---|---|---|
| 业务规则 Skill（代码规范/业务约束） | 已有 | cursor-skills 主体，场景规则沉淀 |
| UI 设计 Skill（设计系统） | 已有 | design-systems |
| Prompt 模板 | 已有 | prompts |
| 集成工具 Skill（MCP/API） | 第一批已完成（3） | Tool 接入、API 幂等、Webhook 事件桥接 |
| 数据上下文 Skill（字典/口径/主数据） | 第一批已完成（3） | 字段字典、指标口径、主数据对齐 |
| 测试验收 Skill（测试集/验收规则） | 第一批已完成（3） | 规则回归、流程门禁、SLA 验收 |
二、与项目定位的匹配
你的站点目标是“让访客快速理解能力并联系合作”，主要读者是企业决策层、业务负责人、产品/技术负责人。
因此 Skill 组织策略应是：
- 第一层展示可直接复制的规则资产（降低理解成本）
- 第二层展示 UI 设计与 Prompt（显示交付完整性）
- 第三层补齐集成/数据/测试类 Skill（显示工程化能力）
三、现状盘点
- 已集中到
proven/dev-assets/cursor-skills：28 个可复制 Skill - 已集中到
proven/dev-assets/cursor-skills/scripts：3 个可执行校验脚本 - 已集中到
proven/dev-assets/design-systems：3 个 UI 设计系统 - 已集中到
proven/dev-assets/prompts：3 个 Prompt 模板 - 各场景
03-开发资产的规则类与工程化类第一阶段已落库
四、阶段化落库清单
P0（已完成 6/6）
| Skill 名称（建议） | 来源场景 | 目标文件 |
|---|---|---|
gps-trajectory-validation（GPS 轨迹验证） | 医废全流程追溯 | /proven/dev-assets/cursor-skills/gps-trajectory-validation.md |
resource-booking-conflict（资源预约冲突检测） | 校园后勤服务 | /proven/dev-assets/cursor-skills/resource-booking-conflict.md |
emergency-dispatch-grading（应急分级与派单） | 应急抢修调度 | /proven/dev-assets/cursor-skills/emergency-dispatch-grading.md |
qualification-expiry-alert（资质到期提醒） | 建筑施工安全 | /proven/dev-assets/cursor-skills/qualification-expiry-alert.md |
sensor-anomaly-monitoring（采集与异常预警） | 水利工程巡检 | /proven/dev-assets/cursor-skills/sensor-anomaly-monitoring.md |
defect-classification-dispatch（病害识别与派单） | 交通设施维护 | /proven/dev-assets/cursor-skills/defect-classification-dispatch.md |
P1 第一批（已完成 3/3）
| Skill 名称（建议） | 来源场景 | 目标文件 |
|---|---|---|
mine-evacuation-routing（井下定位与撤离） | 矿山安全巡检 | /proven/dev-assets/cursor-skills/mine-evacuation-routing.md |
workorder-state-machine（工单状态流转） | 物业报修巡检 | /proven/dev-assets/cursor-skills/workorder-state-machine.md |
dispatch-score-policy（派单评分策略） | 物业报修巡检 | /proven/dev-assets/cursor-skills/dispatch-score-policy.md |
P1 第二批（已完成 3/3）
| Skill 名称（建议） | 来源场景 | 目标文件 |
|---|---|---|
multi-level-approval-flow（多级审批流程） | 校园后勤服务 | /proven/dev-assets/cursor-skills/multi-level-approval-flow.md |
rectification-closed-loop（整改闭环跟踪） | 建筑施工安全 | /proven/dev-assets/cursor-skills/rectification-closed-loop.md |
maintenance-plan-scheduler（维护计划自动生成） | 水利工程巡检 | /proven/dev-assets/cursor-skills/maintenance-plan-scheduler.md |
P2 MCP/API 集成（已完成 3/3）
| Skill 名称（建议） | 来源场景 | 目标文件 |
|---|---|---|
mcp-tool-adapter-pattern（MCP 工具接入与适配） | 跨场景工程化 | /proven/dev-assets/cursor-skills/mcp-tool-adapter-pattern.md |
api-idempotency-retry（API 幂等与重试） | 跨场景工程化 | /proven/dev-assets/cursor-skills/api-idempotency-retry.md |
webhook-event-bridge（Webhook 事件桥接） | 跨场景工程化 | /proven/dev-assets/cursor-skills/webhook-event-bridge.md |
P2 数据上下文（已完成 3/3）
| Skill 名称（建议） | 来源场景 | 目标文件 |
|---|---|---|
domain-data-dictionary（领域数据字典） | 跨场景工程化 | /proven/dev-assets/cursor-skills/domain-data-dictionary.md |
metric-caliber-governance（指标口径治理） | 跨场景工程化 | /proven/dev-assets/cursor-skills/metric-caliber-governance.md |
master-data-alignment（主数据对齐） | 跨场景工程化 | /proven/dev-assets/cursor-skills/master-data-alignment.md |
P2 测试验收（已完成 3/3）
| Skill 名称（建议） | 来源场景 | 目标文件 |
|---|---|---|
rule-regression-test-suite（规则引擎回归测试） | 跨场景工程化 | /proven/dev-assets/cursor-skills/rule-regression-test-suite.md |
workflow-acceptance-gates（工作流验收门禁） | 跨场景工程化 | /proven/dev-assets/cursor-skills/workflow-acceptance-gates.md |
sla-observability-validation（SLA 与可观测性验收） | 跨场景工程化 | /proven/dev-assets/cursor-skills/sla-observability-validation.md |
P3 scripts 校验版（已完成 3/3）
| 脚本文件 | 对应 Skill | 目标文件 |
|---|---|---|
check-api-idempotency.cjs | api-idempotency-retry | /proven/dev-assets/cursor-skills/scripts/check-api-idempotency.cjs |
check-data-dictionary.cjs | domain-data-dictionary | /proven/dev-assets/cursor-skills/scripts/check-data-dictionary.cjs |
check-workflow-gates.cjs | workflow-acceptance-gates | /proven/dev-assets/cursor-skills/scripts/check-workflow-gates.cjs |
五、执行顺序建议
- 继续保持
cursor-skills/index.md的“行业 + 能力标签”结构更新 - P3 已完成首批 scripts 校验版，下一步可补用例自动生成脚本
- 后续补
resources与prompts的配套，形成“规则 + 集成 + 数据 + 质量 + 自动化”闭环