Requirement Assessment
v1.0.0需求细化与工时评估技能。接收用户需求(文本或截图),主动询问澄清问题,分析需求合理性,输出合并的需求清单 + 工时评估表,并创建飞书 Bitable 多维表。适用于项目立项、需求评审、工时估算场景。
Security Scan
OpenClaw
Suspicious
high confidencePurpose & Capability
技能声明会在飞书 Bitable 中创建多维表并逐行写入记录(调用 feishu_bitable_create_app、feishu_bitable_create_field、feishu_bitable_create_record)。要执行这些操作,代理需要飞书的访问令牌或平台级别的集成权限,但注册元数据和 SKILL.md 中未声明任何需要的环境变量、主凭据或安装步骤来获取这些权限,导致目的与所需能力不一致。
Instruction Scope
SKILL.md 指令范围清晰(必须向用户主动询问澄清问题、拆解需求、生成工时并在 Bitable 中创建字段与记录)。但指令明确要求“直接创建飞书多维表,不再输出 markdown”,也列出具体的 feishu_bitable_* 调用步骤——这是对外部 API 的网络操作且会写入用户工作区,技能未说明会如何认证或请求用户授权,存在未声明的外部通信与写入行为。除此之外,指令没有要求读取本地敏感文件或其他凭据。
Install Mechanism
技能为 instruction-only、无安装规范、无二进制或代码文件,静态触达面较小(没有在本地写入或下载代码)。这在一般情况下风险较低,但因技能期望调用外部服务(飞书),其能力依赖于平台提供的运行时动作/集成。
Credentials
技能声明要与飞书交互以创建/写入 Bitable,但 requires.env 与 primary credential 均为空;没有显式要求 FEISHU_TOKEN、APP_ID/APP_SECRET、或类似的访问凭据。这是不成比例的:对外部服务写权限通常需要明确凭据或权限范围。若平台隐式提供 feishu 动作并自动注入凭据,应在文档中说明并限定权限范围(例如仅写入指定空间/表),但当前无此说明。
Persistence & Privilege
技能没有设置 always: true,默认允许用户调用且不要求持久驻留或修改其他技能配置。没有显示要求提升代理系统权限或写入系统级配置,持久性/特权请求看起来合理。
What to consider before installing
简单说明与建议:
1) 主要问题:技能会“直接创建飞书 Bitable”并调用 feishu_bitable_* 操作,但清单中没有声明任何飞书凭据或说明如何获得授权——在安装或使用前,询问技能提供者或平台:
- 这些 feishu_bitable_* 动作由平台托管且自动注入凭据吗?如果是,凭据的权限范围是什么(仅当前用户空间?组织级?)?
- 如果需要手动提供凭据,技能应明确要求哪些环境变量(例如 FEISHU_APP_ID/APP_SECRET 或 ACCESS_TOKEN)以及建议的最小权限。
2) 权限最小化:不要向技能提供全局或长期有效的组织级令牌。优先使用作用域受限、可撤销的集成账号或在测试环境中先试用。要求技能只获得“在指定空间/文件夹中创建表和写记录”的最小权限。
3) 行为验证:安装后(或在安全测试环境中),验证技能实际调用的端点与 SKILL.md 一致,确认写入的表名/空间是你允许的,并检查是否有额外的数据外发或敏感信息上报。
4) 若你无法得到关于凭据来源/权限范围的明确说明:将该技能视为需要额外审查(suspicious),并避免在生产组织或主账户中授权其写权限;可以先在隔离的飞书测试空间进行评估。
5) 其他注意项:SKILL.md 要求接收截图/图片作为输入。确认平台或技能在上传图片时如何存储与传输这些附件(是否发送到第三方服务器、保留多久等)。Like a lobster shell, security has layers — review code before you run it.
latest
需求评估技能
核心目标
理解清晰、准确、细化完善、风险可控、评估合理
工作流程
第一步:接收需求
用户可能提供:
- 文本需求:直接描述功能或业务场景
- 截图/图片:界面草图、流程图、参考图
第二步:主动询问(必须)
收到需求后,必须主动询问以下关键问题(根据需求情况选择相关问题):
客户背景
- 这是老客户还是新客户?
- 客户所属行业?是否有特殊合规要求?
系统现状
- 这是全新开发,还是在已有系统上补充/改造?
- 如果是改造,原有系统技术栈是什么?是否有代码/文档可参考?
需求边界
- 需求的预期上线时间?是否有硬性 deadline?
- 目标用户群体是谁?预计用户规模?
- 是否需要多端支持(Web/iOS/Android/鸿蒙/小程序)?
技术约束
- 是否有指定的技术栈或平台要求?
- 是否需要与现有第三方系统集成?有哪些系统?
其他
- 是否有参考产品或竞品?
- 预算范围是否有预期?
第三步:需求分析
3.1 需求合理性评估
- 技术可行性:是否有成熟方案?技术风险点?
- 业务合理性:是否解决真实痛点?使用频率?
- 成本效益:投入产出比如何?是否有更优方案?
3.2 需求细化
基于用户回答,将需求拆解为:
- 子系统/模块划分
- 功能点列表
- 各功能点详细描述
第四步:创建飞书 Bitable 多维表(直接输出)
不再输出 markdown 表格,直接创建飞书多维表。
创建前询问用户(如未提供):
- 在哪个飞书空间/文件夹创建?(或使用默认空间)
- 表格名称(默认:
需求评估-YYYYMMDD-项目名称)
创建步骤:
- 使用
feishu_bitable_create_app创建新的 Bitable 应用 - 使用
feishu_bitable_create_field创建以下字段 - 使用
feishu_bitable_create_record逐行创建记录 - 返回 Bitable 链接给用户
字段设计(17 个字段):
| 字段名 | 字段类型 | 说明 |
|---|---|---|
| 序号 | 自动编号 | 1001 类型 (AutoNumber) |
| 需求目标/场景 | 文本 | 1 类型 (Text) |
| 原始需求描述 | 文本 | 1 类型 (Text) |
| 子模块/子系统 | 单选 | 3 类型 (SingleSelect),预设常见模块选项 |
| 功能点 | 文本 | 1 类型 (Text) |
| 需求描述 | 多行文本 | 1 类型 (Text) |
| 产品 | 数字 | 2 类型 (Number),单位:人·天 |
| UI | 数字 | 2 类型 (Number),单位:人·天 |
| 前端 | 数字 | 2 类型 (Number),单位:人·天 |
| 后端 | 数字 | 2 类型 (Number),单位:人·天 |
| 测试 | 数字 | 2 类型 (Number),单位:人·天 |
| 运维 | 数字 | 2 类型 (Number),单位:人·天 |
| iOS | 数字 | 2 类型 (Number),单位:人·天 |
| Android | 数字 | 2 类型 (Number),单位:人·天 |
| 鸿蒙 | 数字 | 2 类型 (Number),单位:人·天 |
| 小计 (标准) | 数字 | 2 类型 (Number),公式或手动计算 |
| 小计 (AI 辅助) | 数字 | 2 类型 (Number),公式或手动计算 |
工时说明:
- 标准工时:常规开发模式下的预估工时
- AI 辅助工时:在 AI 辅助(代码生成、文档生成等)情况下的预估工时
- 工时单位:人·天(允许小数)
- 如果某岗位不涉及,填
0
第五步:风险提示
列出主要风险点:
- 技术风险
- 需求变更风险
- 工期风险
- 其他风险
输出示例
Bitable 记录示例
创建后的 Bitable 记录:
记录 1:
- 序号:1
- 需求目标/场景:用户登录
- 原始需求描述:"用户可以登录系统"
- 子模块/子系统:用户系统
- 功能点:手机号登录
- 需求描述:用户输入手机号和验证码,验证通过后登录系统,支持 60 秒重发
- 产品:0.5 | UI:0.5 | 前端:1 | 后端:1 | 测试:0.5 | 运维:0.2
- iOS:0 | Android:0 | 鸿蒙:0
- 小计 (标准):3.7 | 小计 (AI 辅助):2.5
记录 2:
- 序号:2
- 需求目标/场景:用户登录
- 原始需求描述:"用户可以登录系统"
- 子模块/子系统:用户系统
- 功能点:微信登录
- 需求描述:用户点击微信登录,跳转微信授权,获取用户信息并绑定账号
- 产品:0.5 | UI:0.3 | 前端:1.5 | 后端:2 | 测试:0.8 | 运维:0.2
- iOS:0 | Android:0 | 鸿蒙:0
- 小计 (标准):5.3 | 小计 (AI 辅助):3.5
注意事项
- 必须主动询问:不要直接给出评估,先问清楚背景
- 工时合理:基于
references/评估标准.md的基准,结合需求复杂度调整 - 风险透明:不确定的地方要明确标注,不要过度承诺
- AI 辅助说明:AI 辅助工时可作为参考,实际需考虑审核修改时间
- 平台差异:如果用户未指定平台,按 Web 评估,移动端单独列出
- Bitable 输出:不再输出 markdown 表格,直接创建飞书多维表
- 工时汇总:可在 Bitable 中添加视图或使用公式字段自动计算各岗位合计
相关资源
- 评估标准和工时基准:
references/评估标准.md - 常见功能模块参考:
references/常见功能模块.md
Comments
Loading comments...
