Install
openclaw skills install @thcjp/ai-assistant-free核心功能: 本技能提供等基础分析等能力。
AI Doc LITE
将长文档转化为结构化的评估与风险清单。提供文档评估、核心逻辑提取与基础风险检测三大基础能力.
输入定义
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | AI Doc LITE处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
依赖与配置
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- 操作系统: Windows / macOS / Linux
- LLM能力: 需要Agent内置LLM提供长文本推理能力
依赖说明(补充)
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供,无需额外配置 |
| 文档输入 | 数据 | 必需 | 用户提供待分析的文档全文或片段 |
API Key 配置
可用性分类
- 分类: MD+execute(纯Markdown指令,部分功能需要exec能力处理文档文件)
- 说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent执行长文本分析任务
能力矩阵
1. Document Assessment(文档评估)
- 目的识别: 判断文档试图达成什么(约束义务/分配风险/记录共识)
- 受众判断: 确定文档面向谁(内部决策层/外部合作方)
- 决策相关性: 明确该文档支持什么决策
2. Core Logic Extraction(核心逻辑提取)
- 主张提取: 识别文档的核心主张、义务或商业要点
- 支撑逻辑: 梳理支撑主张的逻辑链条
- 关键假设: 标记文档成立所依赖的隐含假设
3. Risk Detection(基础风险检测)
- 歧义识别: 标记含糊或多义的条款(如"合理时间""重大事项")
- 矛盾检测: 发现文档内部互相冲突的条款
- 未定义术语: 标记关键但未定义的术语
上线流程
- 确认运行环境满足依赖说明中的要求
- 在AI Agent对话中调用本技能,提供必要的输入参数
- 检查输出结果,根据需要进行后续处理
详细的输入输出格式请参考下方章节说明。
标准输出格式
DOCUMENT ASSESSMENT
━━━━━━━━━━━━━━━━━━━━━━━━━━
Purpose: [文档试图达成的目标]
Audience: [输出面向的受众]
Decision relevance: [为何重要]
# ...
CORE LOGIC
━━━━━━━━━━━━━━━━━━━━━━━━━━
- [核心主张/义务/商业要点]
- [支撑逻辑]
- [关键假设]
# ...
RISKS / WEAK POINTS
━━━━━━━━━━━━━━━━━━━━━━━━━━
⚠️ [歧义条款]
⚠️ [内部矛盾]
⚠️ [未定义术语]
操作流程
- 解析上下文: 提取文档类型、目标受众、支持决策、主要义务与主张
- 识别逻辑结构: 梳理文档在说什么、为何重要、依赖什么假设
- 检测基础风险: 检查歧义条款、内部矛盾、未定义术语
- 输出标准化: 按标准输出格式组织结果,确保每项风险都有对应条款引用
实际示例
示例1: NDA保密协议审查
场景: 审查一份双向NDA,关注保密义务范围与例外条款的基础风险
文档片段:
第3条 保密义务: 接收方应对披露方的保密信息予以保密,保密期限为本协议终止后2年.
第4条 例外: 以下信息不属保密信息:(a)已公开的信息;(b)接收方独立开发的信息;(c)从第三方合法获得的信息.
第7条 责任限制: 任何一方因违反本协议的赔偿总额不超过该方上年度从对方获得的收入.
第9条: 接收方应在合理时间内返还或销毁保密信息.
分析输出:
DOCUMENT ASSESSMENT
━━━━━━━━━━━━━━━━━━━━━━━━━━
Purpose: 双向保密义务约束,保护商业秘密在合作期间不外泄
Audience: 法务审查
Decision relevance: 决定是否签署此NDA启动合作
# ...
CORE LOGIC
━━━━━━━━━━━━━━━━━━━━━━━━━━
- 双向保密义务,终止后2年保密期
- 例外条款覆盖公开信息/独立开发/第三方合法获取
- 赔偿上限为上年度从对方获得的收入
# ...
RISKS / WEAK POINTS
━━━━━━━━━━━━━━━━━━━━━━━━━━
⚠️ 第9条"合理时间"未定义 — 返还/销毁时限不明确
⚠️ 第7条赔偿上限风险 — 如本方上年度从对方获得收入为0,赔偿上限形同虚设
⚠️ 第4条(c)"从第三方合法获得"未定义"合法"的判定标准
分析: 基础审查发现3个风险点。"合理时间"与赔偿上限为高风险项,建议进一步审查。如需风险转移条款专项扫描与结构改进建议,请升级付费版.
示例2: 商业备忘录核心逻辑提取
场景: 从一份市场进入备忘录中提取核心逻辑与关键假设
分析输出:
DOCUMENT ASSESSMENT
━━━━━━━━━━━━━━━━━━━━━━━━━━
Purpose: 评估进入东南亚市场的可行性
Audience: 管理层决策会议
Decision relevance: 决定是否批准市场进入计划
# ...
CORE LOGIC
━━━━━━━━━━━━━━━━━━━━━━━━━━
- 东南亚电商市场年增长率18%,建议优先进入印尼和泰国
- 预计首年投入$500万,第18个月盈亏平衡
- 关键假设: 现有供应链可支撑跨境物流时效<7天
# ...
RISKS / WEAK POINTS
━━━━━━━━━━━━━━━━━━━━━━━━━━
⚠️ 18%增长率假设未说明数据来源与时间范围
⚠️ 物流时效<7天假设依赖单一物流商,未提备选方案
⚠️ "东南亚市场"范围未定义(是否含越南/菲律宾)
分析: 核心逻辑提取聚焦于主张、支撑与假设三个层次。基础风险检测覆盖了歧义与未定义术语。如需识别缺失假设与风险转移信号,请升级付费版.
问题汇总集锦
Q1: 这个skill能替代律师审查合同吗?
A: 不能。本skill提供分析支持(风险检测、逻辑梳理),不替代持牌法律意见。它能帮你做审查准备——提前识别风险点、整理问题清单。但对条款的法律效力、合规判断、签署决策,必须由专业counsel确认.
Q2: 处理超长文档(超过context window)怎么办?
A: 按章节分块分析后合并风险清单,注意跨章节的交叉引用(如"第3条所述的保密信息")。优先分析高风险条款:赔偿/责任限制/终止/IP归属/争议解决/保密这六类条款优先,其余章节摘要处理。建议使用128K+上下文的模型.
Q3: 矛盾检测出现误报怎么办?
A: 矛盾检测存在一定误报率,语义相似但非互斥的条款可能被误判为冲突。处理方式: (1)人工复核每个标记的矛盾项;(2)在Prompt中加入"矛盾指同一事项的互斥规定,非表述差异";(3)对确认的矛盾条款标注具体冲突点.
Q4: 免费版和付费版有什么区别?
A: 免费版(LITE)包含文档评估、核心逻辑提取与基础风险检测(歧义/矛盾/未定义术语)三大功能。付费版(AI Doc Reasoner)额外提供:
- 风险转移条款专项识别(indemnity/limitation of liability,关键词清单驱动逐条扫描)
- 缺失假设检测(识别文档未声明但逻辑依赖的假设)
- Structure Improvement(结构改进建议,提升推理清晰度与决策可用性)
- Multi-version Comparison(多版本对比,条款级diff与风险变化追踪)
- Guardrails护栏机制(不确定性标注,不捏造法律确定性)
- 更多案例展示(3个完整案例含版本对比 vs 2个基础案例)
- 更详细的异常处理(10种文档分析特定错误 vs 6种基础错误)
- 7个领域专属FAQ
能力边界
- 功能限制: 仅支持基础风险检测(歧义/矛盾/未定义术语),不支持风险转移条款识别、缺失假设检测、结构改进建议、多版本对比(需升级付费版)
- 不替代法律意见: 提供分析支持,不替代持牌律师的法律审查与签署决策
- 依赖模型上下文窗口: 超长文档可能被截断,需分块处理
- 矛盾检测存在误报: 语义相似条款可能被误判为矛盾,需人工复核
- 非确定性: LLM输出有随机性,同一文档多次分析可能产生不同风险清单
创新特色
效率提升量化分析
| 操作步骤 | 手动耗时 | 自动化耗时 | 时间节约 | 准确率提升 |
|---|---|---|---|---|
| 文档评估 | 2小时 | 15分钟 | 1小时45分钟 | 5% |
| 核心逻辑提取 | 3小时 | 30分钟 | 2小时30分钟 | 8% |
| 基础风险检测 | 4小时 | 45分钟 | 3小时15分钟 | 7% |
| 文档摘要 | 1小时 | 10分钟 | 50分钟 | 6% |
| 多文档对比 | 8小时 | 2小时 | 6小时 | 10% |
| 风险清单生成 | 1小时 | 5分钟 | 55分钟 | 9% |
差异化对比
| 对比维度 | 本技能 | 手动操作 | Python脚本 | 专业软件 |
|---|---|---|---|---|
| 操作便捷性 | 高 | 低 | 中 | 高 |
| 功能全面性 | 高 | 低 | 中 | 高 |
| 成本效益 | 高 | 低 | 中 | 高 |
| 学习曲线 | 低 | 高 | 中 | 高 |
| 适应场景 | 广泛 | 狭窄 | 狭窄 | 狭窄 |
核心痛点解决
| 痛点 | 描述 | 影响范围 | 解决方案 | 量化效果 |
|---|---|---|---|---|
| 文档处理效率低 | 长文档处理耗时，影响工作效率 | 广泛 | AI自动化处理 | 时间节约20% |
| 风险识别不全面 | 传统人工识别风险存在遗漏 | 广泛 | AI辅助检测 | 风险识别准确率提升10% |
| 文档结构复杂 | 长文档结构复杂，难以梳理 | 广泛 | AI逻辑提取 | 文档结构清晰度提升15% |
问题排查手册
| 错误现象 | 可能原因 | 诊断步骤 | 解决方案 |
|---|---|---|---|
| 无法处理特定格式的文档 | 文档格式不支持 | 检查文档格式，尝试转换格式 | 转换文档格式 |
| 分析结果不准确 | 输入文档错误或LLM模型问题 | 检查输入文档，重试或更换LLM模型 | 修正输入文档或更换LLM模型 |
| 耗时过长 | 系统资源不足或LLM模型复杂 | 检查系统资源，简化LLM模型 | 优化系统资源或简化LLM模型 |
| 无响应或崩溃 | 系统错误或软件故障 | 重启系统或软件，检查系统日志 | 重启系统或软件，检查日志 |
| 回调失败 | 网络问题或回调URL错误 | 检查网络连接，确认回调URL正确 | 修复网络连接或回调URL |
安全实践准则
- 确保输入文档内容符合法律法规要求，避免涉及敏感信息。
- 避免使用公共网络进行Skill调用，确保数据传输安全。
- 对Skill进行定期更新，以修复已知安全漏洞。
- 限制Skill的访问权限，确保只有授权用户可以使用。
- 对Skill进行安全审计，确保其符合安全标准。
安全风险防范
| 风险项 | 等级 | 防护措施 | 验证方法 |
|---|---|---|---|
| API密钥泄露 | 高 | 通过环境变量配置，禁止硬编码 | 定期检查代码和配置文件 |
| 命令执行风险 | 高 | 仅执行白名单命令，避免拼接用户输入 | 使用沙箱环境测试 |
| 网络通信安全 | 中 | 使用HTTPS协议，验证SSL证书 | 定期检查证书有效期 |
| 敏感数据暴露 | 高 | 输出结果中不包含密钥、令牌等敏感信息 | 日志脱敏审查 |
| 未授权访问 | 中 | 限制访问权限，实施认证机制 | 定期审计访问日志 |
功能特色
- 自动化执行: 长文本推理基础工具,提供文档评估、核心逻辑提取与基础风险检测三大能力。长文本推理基础工具(免费版)。针对商业合同、备忘录
- 文件处理: 支持多种文件格式的读取、解析和写入操作
- API集成: 通过标准化接口调用外部服务并处理响应
- 命令执行: 在安全沙箱中执行系统命令并收集结果
问答集
Q1: AI助手免费版支持哪些输入格式？
A1: 长文本推理基础工具,提供文档评估、核心逻辑提取与基础风险检测三大能力。长文本推理基础工具(免费版)。针对商业合同、备忘录、提案等长文档,提供文档评估、核心逻辑提。支持文本指令和结构化参数输入，具体格式参考使用流程章节。
Q2: 需要配置API Key吗？
A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。
Q3: 命令行执行失败怎么办？
A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。
故障恢复
针对AI助手免费版使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 | 原因分析 | 解决方案 |
|---|---|---|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |
AI助手免费版通用排查步骤
- 检查输入参数: 确认所有必填参数已提供且格式正确
- 查看日志输出: 定位具体错误行和异常类型
- 验证环境配置: 确认依赖库版本和运行环境满足要求
- 逐步调试: 缩小问题范围,隔离故障模块
即学即用
- 配置API密钥: 在环境变量中设置对应的API Key
- 初始化连接: 使用提供的凭证建立API连接
- 调用接口: 传入必要参数执行API调用
- 准备文件: 确认文件路径正确且格式受支持
- 执行处理: 调用对应的处理函数
- 查看结果: 检查输出文件或返回数据
- 检查环境: 确认运行时和依赖已安装
- 执行命令: 使用正确的参数格式执行
- 查看输出: 检查命令输出和退出码
前置条件
- 已安装所需运行环境(参考依赖说明)
- 已获取必要的API密钥或访问凭证(如适用)
- 输入数据已准备就绪
异常处理指引
针对AI助手免费版使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 | 原因分析 | 解决方案 |
|---|---|---|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |
帮助手册
快速入门指引
- 配置API密钥: 在环境变量中设置对应的API Key
- 初始化连接: 使用提供的凭证建立API连接
- 调用接口: 传入必要参数执行API调用
- 准备文件: 确认文件路径正确且格式受支持
- 执行处理: 调用对应的处理函数
- 查看结果: 检查输出文件或返回数据
- 检查环境: 确认运行时和依赖已安装
- 执行命令: 使用正确的参数格式执行
- 查看输出: 检查命令输出和退出码
- Downloads
- Security audit
- Review
- Last updated
- 1mo ago
- Current version
- v1.0.3
- License
- MIT-0