القائمة
将网页内容转换为 IMA 笔记的技能。 当用户提供一个 URL 链接，希望将其内容整理成笔记并保存到 IMA 时使用此技能。 自动识别内容类型，匹配合适的模板（API文档、知识库、项目文档、会议纪要等）， 生成结构化的 Markdown 笔记并上传到 IMA 平台。 保存位置支持个人知识库和共享知识库，可选择根目录或指定文件夹。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | ima-web-to-note |
| description | 将网页内容转换为 IMA 笔记的技能。 当用户提供一个 URL 链接，希望将其内容整理成笔记并保存到 IMA 时使用此技能。 自动识别内容类型，匹配合适的模板（API文档、知识库、项目文档、会议纪要等）， 生成结构化的 Markdown 笔记并上传到 IMA 平台。 保存位置支持个人知识库和共享知识库，可选择根目录或指定文件夹。 |
| homepage | https://ima.qq.com |
| metadata | {"openclaw":{"emoji":"📄","requires":{"env":["IMA_OPENAPI_CLIENTID","IMA_OPENAPI_APIKEY"]},"primaryEnv":"IMA_OPENAPI_CLIENTID"},"skill_type":"content_processing","input_type":"url","output_type":"ima_note"} |
将网页内容智能转换为 IMA 笔记的技能。支持自动识别内容类型、匹配合适模板、生成结构化笔记。
当用户调用此技能时，必须自动使用 AskUserQuestion 工具逐步询问用户保存位置。不得跳过此步骤或自行假设保存位置。
交互流程如下：
// 问题1：选择知识库类型
AskUserQuestion({
question: "您希望将笔记保存到哪个知识库？",
header: "知识库类型",
options: [
{ label: "个人知识库", description: "保存到您的个人知识库" },
{ label: "共享知识库", description: "保存到共享知识库（可与他人共享）" }
],
multiSelect: false
})
// 问题2：选择知识库
AskUserQuestion({
question: "请选择具体的知识库：",
header: "选择知识库",
options: [...] // 从 get_addable_knowledge_base_list 或 search_knowledge_base 获取
})
// 问题3：选择保存位置
AskUserQuestion({
question: "保存到根目录还是指定文件夹？",
header: "保存位置",
options: [
{ label: "根目录", description: "保存到知识库根目录" },
{ label: "选择文件夹", description: "保存到指定文件夹" }
],
multiSelect: false
})
// 问题4：选择文件夹（如果选择了"选择文件夹"）
AskUserQuestion({
question: "请选择目标文件夹：",
header: "选择文件夹",
options: [...] // 从 get_knowledge_list 获取文件夹列表
})
// 问题5：确认文档名称
AskUserQuestion({
question: "请确认或修改笔记标题：",
header: "文档名称",
options: [
{ label: "使用提取的标题", description: "自动提取的标题" },
{ label: "自定义标题", description: "您来指定标题" }
]
})
目标：获取完整的网页内容，包括主文档和相关子文档。
抓取策略：
page-import 工具或 WebFetch 抓取目标 URL 的全部内容github.com/*）：
https://github.com/{owner}/{repo}）docs/ 目录下的所有 .md 文件skills/ 目录下的所有 SKILL.md 文件.github/ 目录下的文档（如 CONTRIBUTING.md、SECURITY.md）wiki/ 页面（如果存在）Invoke-WebRequest -Uri "https://raw.githubusercontent.com/{owner}/{repo}/main/{path}" -UseBasicParsing 抓取原始 MarkdownWebSearch 搜索 site:github.com/{owner}/{repo} {关键词} 获取内容摘要内容预处理：
根据 URL 和内容特征自动识别内容类型：
| URL 特征 | 内容类型 | 推荐模板 | 识别说明 |
|---|---|---|---|
github.com/{owner}/{repo} | 项目文档 | template-repo.md | GitHub 仓库首页，包含 README 内容 |
github.com/{owner}/{repo}/blob/main/skills/ | 技能文档 | template-skill.md | 技能说明文档，包含工作流程和规则 |
github.com/{owner}/{repo}/blob/main/docs/ | 知识文档 | template-knowledge.md | 教程、指南、最佳实践 |
github.com/*/api | API 文档 | template-api.md | API 接口说明文档 |
包含 /docs/、/guide/、/tutorial/ | 知识文档 | template-knowledge.md | 教程、指南、最佳实践 |
包含 /decision/、/adr/ | 技术决策 | template-decision.md | 架构决策记录、设计评审 |
包含 /meeting/、/meeting-notes/ | 会议纪要 | template-meeting.md | 会议记录、讨论总结 |
包含 /incident/、/postmortem/ | 事故报告 | template-incident.md | 故障分析、事后总结 |
包含 /rfc/、/proposal/ | 技术方案 | template-rfc.md | 技术提案、方案设计 |
包含 /security/、/vulnerability/ | 安全评审 | template-security-review.md | 安全评估、漏洞分析 |
包含 /performance/、/benchmark/ | 性能测试 | template-performance-test.md | 性能报告、基准测试 |
包含 /runbook/、/playbook/ | 运维手册 | template-runbook.md | 操作手册、应急流程 |
包含 /onboarding/、/getting-started/ | 入职指南 | template-onboarding.md | 新人引导、环境搭建 |
包含 /prd/、/product-requirements/ | 产品需求 | template-prd.md | 产品需求文档 |
包含 /retro/、/retrospective/ | 回顾会议 | template-retro.md | 迭代回顾、总结反思 |
| 默认匹配失败 | 通用文档 | template-knowledge.md | 无法识别时的降级选择 |
内容特征识别（当 URL 特征不明显时）：
GET /api/v1/users、参数表格） → API 文档必须保留的内容：
必须移除的内容：
内容重组原则：
从 references/template/ 目录读取对应模板，按照模板格式填充内容：
const fs = require('fs');
const templatePath = 'references/template/{对应模板}.md';
const template = fs.readFileSync(templatePath, 'utf8');
// 替换模板中的占位符为实际内容
填充要求：
const { searchKnowledgeBases, getFolders } = require('../../ima-skill/scripts/knowledge_base.js');
const { createNote } = require('../../ima-skill/scripts/notes.js');
// 1. 获取知识库信息
const kbData = await searchKnowledgeBases();
const kbId = kbData.data.info_list[0].kb_id;
// 2. 获取文件夹列表（如需要）
const folders = await getFolders(kbId);
// folders 格式: [{ media_id: "folder_xxx", title: "文件夹名" }, ...]
// 3. 创建笔记
const noteId = await createNote(noteContent);
// 注意: 笔记标题由 content 第一行的 # 标题决定
// 4. 添加到知识库
const { addNoteToKnowledgeBase } = require('../../ima-skill/scripts/knowledge_base.js');
await addNoteToKnowledgeBase(noteId, noteTitle, kbId, folderId);
// folderId 省略则为根目录
上传前验证：
// 个人知识库
await imaApi('openapi/wiki/v1/search_knowledge_base', {
query: "",
cursor: "",
limit: 20
});
// 共享知识库
await imaApi('openapi/wiki/v1/search_knowledge_base', {
query: "",
cursor: "",
limit: 20,
base_type: 1 // 1 = 共享知识库
});
const { getFolders } = require('../../ima-skill/scripts/knowledge_base.js');
const folders = await getFolders(kbId);
// folders 格式: [{ media_id: "folder_xxx", title: "文件夹名" }, ...]
适用场景：技术文档、SDK说明、接口文档
处理要点：
适用场景：GitHub README、项目介绍、代码库说明
处理要点：
适用场景：教程、指南、最佳实践、技术文章
处理要点：
适用场景：架构决策、设计评审、方案选择
处理要点：
适用场景：会议记录、讨论总结、决策备忘
处理要点：
| 错误场景 | 处理方式 | 用户提示 |
|---|---|---|
| URL 无法访问 | 尝试备用方法（WebSearch → 手动输入） | "无法访问该链接，请检查 URL 是否正确" |
| 内容提取失败 | 使用 WebSearch 获取摘要，或请求用户手动复制 | "内容提取不完整，请手动粘贴内容" |
| 模板匹配失败 | 使用 template-knowledge.md 作为默认模板 | "已使用通用模板整理内容" |
| 笔记创建失败 | 检查 IMA 凭证配置，参考 ima-skill/SKILL.md | "笔记创建失败，请检查配置" |
| 知识库不存在 | 提示用户检查知识库名称或权限 | "未找到指定知识库，请确认名称或权限" |
| GitHub API 限流 | 使用 raw.githubusercontent.com 直接获取 | "使用备用方式获取内容" |
| 内容过长 | 分段抓取并合并，或只提取核心章节 | "内容较长，已提取主要部分" |
| 多语言内容 | 优先提取中文内容，如无则保留原文 | "已提取英文内容，如需翻译请告知" |
用户：帮我把这个链接整理成笔记：https://example.com/guide/best-practices
处理：
1. 询问保存位置：
- 选择知识库类型：个人/共享
- 选择具体知识库
- 选择保存位置：根目录/文件夹
- 确认文档名称
2. 抓取内容 → example.com 指南文档（使用 WebFetch）
3. 识别类型 → 知识文档 → template-knowledge.md
4. 提取核心概念、操作步骤、注意事项
5. 生成结构化笔记
6. 创建笔记并上传到指定位置
用户：帮我把这个 GitHub 项目整理成笔记：https://github.com/obra/superpowers
处理：
1. 询问保存位置（同上）
2. 抓取内容：
- 主 README: https://github.com/obra/superpowers
- 子文档: skills/systematic-debugging/SKILL.md
- 子文档: skills/test-driven-development/SKILL.md
- 子文档: skills/brainstorming/SKILL.md
（使用 raw.githubusercontent.com 获取原始 Markdown）
3. 识别类型 → 项目文档 → template-repo.md
4. 提取内容：
- 项目简介：AI 代码代理开发方法论
- 安装指南：各平台安装命令
- 核心工作流：7 步标准流程
- 技能库：完整技能列表及详细说明
- 哲学理念：TDD、YAGNI、DRY 等核心原则
5. 生成结构化笔记（包含完整的技能使用说明）
6. 创建笔记并上传到指定位置
用户：帮我把这个 API 文档整理成笔记：https://example.com/api/v2/docs
处理：
1. 询问保存位置（同上）
2. 抓取内容 → API 文档（使用 WebFetch）
3. 识别类型 → API 文档 → template-api.md
4. 提取内容：
- 认证方式：API Key / OAuth 2.0
- 端点列表：GET /users、POST /users、DELETE /users/{id}
- 参数表格：每个端点的请求参数、响应字段
- 示例代码：curl 命令、响应 JSON
- 错误码：400、401、404、500 的说明
5. 生成结构化笔记
6. 创建笔记并上传到指定位置
与 ima-skill 共用相同凭证，读取环境变量或 ~/.config/ima/ 目录下的配置文件：
# 检查凭证是否存在
if ! test -f ~/.config/ima/client_id || ! test -f ~/.config/ima/api_key; then
echo "⚠️ 缺少 IMA 凭证"
echo "请先配置：https://ima.qq.com/agent-interface"
fi
所有可用模板位于 references/template/ 目录：
| 模板文件 | 适用场景 | 内容特征 |
|---|---|---|
| template-api.md | API 文档 | 端点定义、参数表格、请求/响应示例 |
| template-api-design.md | API 设计文档 | 设计原则、版本规划、接口规范 |
| template-knowledge.md | 知识文档 | 概念解释、操作步骤、最佳实践 |
| template-project.md | 项目文档 | 项目介绍、架构说明、部署指南 |
| template-repo.md | 仓库文档 | README 转换、目录结构、开发指南 |
| template-decision.md | 技术决策 | 背景分析、方案对比、最终决策 |
| template-meeting.md | 会议纪要 | 参会信息、议题列表、行动项 |
| template-incident.md | 事故报告 | 时间线、根因分析、改进措施 |
| template-rfc.md | 技术方案 | 问题陈述、方案设计、实施计划 |
| template-security-review.md | 安全评审 | 威胁模型、漏洞评估、修复建议 |
| template-performance-test.md | 性能测试 | 测试环境、基准数据、优化建议 |
| template-runbook.md | 运维手册 | 操作流程、应急处理、故障排查 |
| template-onboarding.md | 入职指南 | 环境搭建、权限申请、学习路径 |
| template-oncall.md | 值班手册 | 监控指标、告警处理、升级流程 |
| template-prd.md | 产品需求 | 用户故事、功能规格、验收标准 |
| template-retro.md | 回顾会议 | 做得好的、待改进的、行动计划 |
| template-skill.md | 技能文档 | 触发条件、工作流程、验证方法 |