一些可能需要的skill支持参考资料

  • skill-inventory-template.md:Skill 规划索引要求&示例,列出所有 Skill 的候选名称、类型、优先级和复杂度等信息。

    md 复制代码

Skill Inventory

基于你对代码库的分析,请将产品中的"人 vs 产品"交互操作抽象为 Agent 可使用的 Skill Inventory。

请注意

  • 不要按照页面机械拆分 Skill。
  • 不要按照单个 API 机械拆分 Skill。
  • 请按照"用户想完成的任务"拆分 Skill。
  • 一个 Skill 应该代表一个 Agent 可以独立帮助用户完成的明确任务。
  • 如果某个任务需要多个步骤,请设计为工作流型 Skill。
  • 如果某个任务风险较高,例如删除、付款、发布、发送通知、修改权限、批量操作,请标记为需要用户确认。
  • 如果某个能力只适合内部管理员使用,请标记角色边界。
  • 如果现有代码不支持 Agent 直接调用,请指出需要补充的后端能力或脚本。

Skill Inventory 建议字段:

| Skill 候选名称 | 类型 | 优先级 | 复杂度 | 用户意图示例 | 对应产品能力 | 依赖接口/函数/数据 | 是否改变状态 | 是否需要确认 | 备注 |

字段说明:

  • 类型:
    • 查询型
    • 操作型
    • 工作流型
    • 管理型
    • 集成型
  • 优先级:
    • P0:核心高频能力,必须封装
    • P1:重要能力,建议封装
    • P2:辅助能力,可后续封装
  • 复杂度:
    • S:现有接口或函数基本可直接复用
    • M:需要组合多个接口、补充引用文档或少量适配
    • L:需要重构后端能力、补充权限控制、新增脚本或新增抽象层
      先给出简单的索引表格,之后每个 Skill 作为三级标题、字段作为四级标题给出详细描述。

示例模板

markdown 复制代码
# Skill Inventory

## 总览

| Skill | 类型 | 优先级 | 复杂度 | 是否改变状态 | 是否需要确认 | 依赖能力 | 备注 |
|---|---|---|---|---|---|---|---|

## 详情

### Skill:<skill-name>

-  中文名称:
-  类型:
-  优先级:
-  复杂度:
-  目标:
-  适用角色:
-  用户意图示例:
    - 
    - 
    - 
-  前端入口:
    - 
-  后端依赖:
    - 
-  数据依赖:
    - 
-  执行流程:
    1. 
    2. 
    3. 
-  输入:
    - 
-  输出:
    - 
-  权限边界:
-  风险点:
-  用户确认点:
-  错误处理:
-  建议资源:
    - `SKILL.md`
    - `references/api.md`
    - `references/schema.md`
    - `references/business-rules.md`
    - `scripts/<script-name>`
    - `assets/<asset-name>`
-  是否需要后端重构:
-  备注:
复制代码
- skill-naming-conventions.md:Skill 命名规范,可选读取
    ```md
请遵循以下 Skill 命名规范:

1. 使用英文小写 kebab-case。
2. 名称表达任务,不表达页面。
3. 避免使用过泛名称,例如:
    - `user-management`
    - `data-helper`
    - `product-agent`
4. 优先使用动词 + 业务对象,例如:
    - `create-project`
    - `search-orders`
    - `summarize-customer-profile`
    - `export-invoice-report`
    - `approve-access-request`
    - `publish-content`
5. 查询型 Skill 可使用:
    - `search-*`
    - `get-*`
    - `list-*`
    - `summarize-*`
    - `analyze-*`
6. 操作型 Skill 可使用:
    - `create-*`
    - `update-*`
    - `delete-*`
    - `submit-*`
    - `send-*`
    - `publish-*`
7. 工作流型 Skill 可使用:
    - `onboard-*`
    - `process-*`
    - `resolve-*`
    - `review-*`
    - `approve-*`
8. 管理型 Skill 可使用:
    - `manage-*`
    - `configure-*`
    - `audit-*`
  • skill-spec.md:Skill 封装规范,必须阅读

    md 复制代码

在构建/封装 Skills 时,请严格遵守以下规则:

  1. 不要凭空创造产品能力。

    • 所有 Skill 候选项都必须能追溯到当前代码中的页面、组件、接口、服务、模型、脚本或测试。
    • 如果只是合理推测,必须标记为"推测"。
  2. 不要把 UI 操作直接等同于 Skill。

    • Skill 应该对应用户任务,而不是按钮、页面或接口。
    • 例如,"点击新建按钮"不是 Skill,"创建项目"才是 Skill。
  3. 不要把 API 直接等同于 Skill。

    • 单个 API 可能只是一个 Skill 的步骤。
    • 多个 API 也可能组成一个工作流型 Skill。
  4. 不要创建巨型 Skill。

    • 一个 Skill 只能服务一个清晰的任务边界。
    • 如果一个 Skill 需要覆盖多个业务对象,请拆分。
    • 如果一个 Skill 同时包含多个风险级别,请拆分。
  5. 不要隐藏风险操作。

    • 删除、发布、付款、授权、批量修改、发送消息、导出敏感数据等操作,必须设计用户确认点。
    • 涉及权限、隐私、安全、审计的操作,必须标注边界。
  6. 不要一开始就改代码。

    • 第一阶段只分析。
    • 第二阶段输出 Skill Inventory。
    • 第三阶段等待确认。
    • 第四阶段才使用 skill-creator 创建 Skills。
  7. 不要把大量代码复制进 SKILL.md

    • SKILL.md 只写任务流程和使用说明。
    • API、Schema、业务规则写入 references/
    • 可重复执行逻辑写入 scripts/
    • 模板、样例、导入导出文件写入 assets/

    在创建 Skill 的 references/ 文档时,遵循以下原则:

    • SKILL.md 保持精简。
    • 复杂、详细、低频读取的信息放入 references/
    • 不要在 SKILL.mdreferences/ 中重复大段内容。
    • 引用文档要能帮助另一个 Agent 准确执行任务。

    解析项目的代码实现,为每个需要引用文档的 Skill 创建或更新以下资料:

    1. API 参考

      • 接口路径或函数名
      • 方法
      • 入参
      • 出参
      • 错误码
      • 权限要求
      • 示例
    2. 数据模型参考

      • 表/模型名称
      • 字段说明
      • 关键状态字段
      • 状态流转规则
      • 关联关系
    3. 业务规则参考

      • 前置条件
      • 校验规则
      • 权限规则
      • 风险操作
      • 用户确认点
      • 回滚或补偿策略
    4. 工作流参考

      • 多步骤流程
      • 每一步依赖什么输入
      • 每一步调用什么能力
      • 每一步如何判断成功或失败
相关推荐
天涯明月19931 小时前
vibe-coding核心方法论
人工智能·大模型·agent·研发流程
暗夜猎手-大魔王1 小时前
hermes源码学习7--会话存储
人工智能·学习
蓝速科技1 小时前
蓝速科技立式 AI 数字人一体机落地实战指南
人工智能·科技
张飞飞飞飞飞1 小时前
目标检测-根据YOLO格式标签统计目标尺寸分布
人工智能·yolo·目标检测
AI客栈1 小时前
云原生 AI 平台:Kubernetes 智能调度器如何让 GPU 利用率翻倍
人工智能
翼达口香糖1 小时前
在普通笔记本上加速大模型:我的OpenVINO异构计算实践
人工智能·边缘计算
Rocky Ding*1 小时前
Token Merging for Fast Stable Diffusion:一篇读懂 Stable Diffusion 的免训练加速机制
论文阅读·人工智能·深度学习·机器学习·stable diffusion·aigc·ai-native
虾壳云官方1 小时前
【一步到位】OpenClaw 2.7.9 Windows 部署 + 激活 + 使用 (含安装包)
人工智能·windows·自动化·openclaw·小龙虾·openclaw安装·openclaw一键安装
椒颜皮皮虾྅1 小时前
OpenVINO™ C# API 3.3 全新发布!正式接入 OpenVINO GenAI,C# 本地大模型开发全面启航!
人工智能·开源·c#·openvino