技能使用手册
本页说明 SkillFlaw 技能模块的入口、界面结构与主要操作路径。 内容覆盖技能列表页、卡片动作与技能详情编辑页。
入口位置
用户通过主菜单 技能 进入该模块。 页面包含两个一级页签：
- 技能开发
- 技能广场
页面截图
本手册包含两张真实截图：一张对应列表页，一张对应详情页。
技能列表页
技能详情页
技能开发页签
“技能开发”页签是所选作用域下的主维护界面。
列表动作
用户可以：
- 创建 SKILL
- 打开技能详情页
- 在卡片菜单中修改技能
- 在卡片菜单中删除技能
筛选项
页面提供以下筛选：
- 范围
- 业务域（当范围为业务域时）
- 是否带附件
- 发布状态
- 删除状态
- 访问类型
- 关键字
删除限制
只有在目标技能满足以下条件时，删除动作才会开放：
- 具备删除权限
- 当前未被删除
- 当前不处于在线状态
技能广场页签
“技能广场”页签是更偏只读的浏览界面。 支持的筛选包括：
- 租户
- 范围
- 业务域
- 是否带附件
- 访问类型
- 关键字
从广场打开卡片时，会进入同一条详情路由，但使用广场只读模式，而不是直接进入编辑路径。
技能详情页
点击技能卡片后，会进入详情编辑页或详情查看页。 当前详情页包含两个内容页签：
- 技能
- 附件
元数据区域
元数据区域对应技能资源的主要字段，包括：
- 名称
- 英文名
- 范围
- 业务域
- 访问类型
- Logo
- 运行语言
- 运行入口
- 备注
- 附件元数据
技能页签
“技能”页签用于维护 markdown 形式的技能正文。 支持的动作包括：
- 保存修改
- 编辑 skill markdown
- 在广场或普通详情只读模式下查看正文
附件页签
“附件”页签是面向附件包的维护区域。 支持的动作包括：
- 导入 ZIP 包
- 导入本地目录
- 清空当前附件包
- 查看当前附件条目
页头动作
根据页面模式与权限，详情页可能暴露以下动作：
- 保存
- 下载
- 测试
- 修改
- 发布
- 上线
- 下线
- 恢复
- 返回 / 取消编辑
运行时测试流程
当测试动作可用时，页面会弹出运行时配置对话框。 测试流程包括：
- 选择 draft 或 online 目标（若可用）
- 选择运行语言
- 选择运行入口
- 填写运行参数或上传运行时文件
- 执行测试并查看结果
- 让页面自动建议运行参数
权限与边界
技能模块遵循平台权限与范围口径：
- 创建只在具备写入权限的范围内开放
- 编辑、发布、上线、下线、保存依赖修改权限
- 删除与恢复依赖删除权限
- 广场详情使用只读模式，而不是复用编辑态
- 技能写边界遵循资源自身 tenant 与 scope 语义