技能人工智能研究
- 作者仓库星标 190
- 作者仓库 skilless.ai
- 领域
- 数据
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @BrikerMan · 未声明许可证
- 上下文用量评级
- 中等消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 命令执行
- 网络行为
- 允许外网请求
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
第 1 步 — 定义范围
在搜索之前,先弄清楚:核心问题是什么?用户实际上需要知道什么?需要哪些来源类型——官方文档、新闻、学术论文、用户评论?哪些维度很重要(价格、性能、兼容性、新近度……)?结论需要有多大的信心?
第 2 步 — 制定研究计划(L3 强制,L2 推荐)
将任务分解为研究维度——每个维度都是一个独立的研究角度。使用`todo`、`tasks`、`todowrite`或等效工具创建可见的任务列表。示例 — “深度搜索 AI 编码领域的创业公司,区分海内外,并简单判断投资潜力”: 规则:L3 必须至少有 3 个维度,通常为 4-6 个维度 每个维度都会有自己的专用搜索轮次
步骤 3 — 执行每维度(多轮搜索)
将每个维度作为重点调查周期来执行: 对于任务列表中的每个维度: 标记为进行中 — 在开始维度之前,将其待办事项状态更新为`in-progress` 搜索 — 针对该特定维度触发 1-3 个并行搜索 读取 — 打开并从搜索结果中读取最相关的来源
第 4 步 — 事实核查
不要跳过此步骤。交叉验证来自多个独立来源的关键数据(目标是 2-3;L3 更多) 如果仅存在单一来源,请明确注明:“基于单一来源 — 未经独立验证” 当来源相互矛盾时:找出原因(时间差异?不同版本?利益冲突?)
第 5 步 — 合成输出
首先是结论 — 提出最重要的发现或建议,然后展开 用`[1]`、`[2]` 等引用每个数据点,以便读者可以验证 对不确定性诚实 — 如果证据有限,请说出来;不要强行下结论以完整的来源列表结束
# Research Skill
Fetch internet content or conduct deep multi-source research.
## Routing Table
| Trigger words | Tool | Purpose |
| ---------------------------------------- | ----------------------- | ---------------------------- |
| search, find, look up | `search.py` | Web, docs, news lookup |
| read, fetch, get page | `web.py` | Extract page text |
| download, extract, subtitles, transcript | `youtube.py` / `yt-dlp` | Video subtitles and metadata |
| convert, compress, encode, ffmpeg | `ffmpeg.py` | Media format conversion |
| research, investigate, analyze, compare | Multi-tool workflow | Deep multi-source research |
When the user intent is ambiguous, ask one clarifying question before proceeding.
---
## Research Depth Levels
Not every request needs a full investigation. Choose the appropriate depth based on complexity, or **ask the user** if unclear.
> **"Round" = one cycle of parallel tool calls.** A single round can fire 3-5 searches/reads in parallel. Rounds are sequential — each round builds on what you learned in the previous one.
| Level | When to use | Minimum effort |
| --------------------------- | ------------------------------------------------------------- | --------------------------------------------------------------- |
| **L1 — Quick lookup** | Single fact, definition, simple question | 1 round, 1-2 searches |
| **L2 — Focused research** | Comparison, how-to, specific topic | 2-3 rounds, 2+ page reads, basic fact-check |
| **L3 — Deep investigation** | Multi-faceted analysis, market research, technical evaluation | **5+ rounds**, 5+ page reads, task list mandatory, full fact-check |
**Decision guide:**
- If the question can be answered with a single search result → **L1**
- If it involves comparing options or understanding a topic in depth → **L2**
- If it requires multiple perspectives, data synthesis, or the user explicitly says "research" / "investigate" / "deep dive" / "深度" → **L3**
- **If you cannot determine the level, ask the user:** "This could be a quick lookup or a deeper investigation — how thorough would you like me to be?"
---
## Research Workflow (L2 and L3)
### Step 1 — Define Scope
Before searching, clarify:
- What is the core question? What does the user actually need to know?
- What source types are needed — official docs, news, academic papers, user reviews?
- What dimensions matter (price, performance, compatibility, recency...)?
- How confident does the conclusion need to be?
If any of the above is unclear, **ask the user** before proceeding.
### Step 2 — Create Research Plan (L3 mandatory, L2 recommended)
**Decompose the task into research dimensions** — each dimension is an independent angle of investigation. Use `todo`, `tasks`, `todowrite`, or equivalent tool to create a visible task list.
Example — "深度检索 AI coding 领域的创业公司,区分海内外,并简单判断投资潜力":
```
[ ] 1. 海外 AI coding 创业公司全景 (who, what, founded when)
[ ] 2. 国内 AI coding 创业公司全景
[ ] 3. 各公司融资情况、投资方、估值
[ ] 4. 产品对比:功能、定价、目标用户
[ ] 5. 市场格局和竞争态势
[ ] 6. 投资潜力评估(团队、技术壁垒、增长、风险)
```
**Rules:**
- L3 must have **at least 3 dimensions**, typically 4-6
- Each dimension will get its own dedicated search round(s)
- Do NOT skip this step — a task list forces thoroughness
### Step 3 — Execute Per-Dimension (Multi-Round Search)
**Execute each dimension as a focused investigation cycle:**
For each dimension in the task list:
1. **Mark in-progress** — Before starting a dimension, update its todo status to `in-progress`
2. **Search** — Fire 1-3 parallel searches targeting this specific dimension
3. **Read** — Open and read the most relevant sources from search results
4. **Record** — Extract key data points and note sources
5. **Mark complete** — Immediately after finishing a dimension, mark it `completed` in the todo list
6. **Adapt** — If new sub-questions, gaps, or unexpected angles emerge, **add new todo items** to the list before moving on; do not silently absorb them
**Dynamic todo updates are mandatory throughout execution:**
- Never batch completions — mark each item done the moment it is finished
- If a dimension turns out to be larger than expected, split it into sub-items
- If a dimension turns out to be irrelevant, mark it `skipped` with a one-line reason
- The todo list is a live document — the user should always be able to glance at it and understand what has been done and what remains
**Search angle variety within each round:**
- **Broad terms** — Get the landscape, find authoritative sources
- **Specific terms** — Target precise data (version numbers, prices, specs)
- **Contrarian terms** — Search for "problems", "downsides", "alternatives", "vs" to find critical perspectives
- **Recency terms** — Add year or "2025" to filter outdated content
- **Multi-language** — Search in both English and Chinese when relevant
**Parallelism:** Within a single round, fire multiple tool calls in parallel (e.g., 3 searches at once, or 2 searches + 1 web read). Each round should maximize parallel execution.
<HARD-GATE>
L3 research MUST NOT proceed to synthesis (Step 5) until:
- At least **5 rounds** of tool calls have been executed
- At least **3 dimensions** have been independently investigated
- At least **5 pages** have been fully read (not just search snippets)
If you have not met these minimums, keep researching. Do NOT shortcut.
</HARD-GATE>
### Step 4 — Fact-Check
**Do not skip this step.**
- Cross-verify key data from multiple independent sources (aim for 2-3; more for L3)
- If only a single source exists, explicitly note: "Based on a single source — not independently verified"
- When sources contradict each other:
1. Identify the reason (timing difference? different versions? conflicting interests?)
2. State which source is more credible and why
3. **If you cannot resolve the contradiction, present both sides and ask the user** how they want to proceed
- Distinguish **facts** from **opinions** — opinions may be cited but must not be stated as facts
- Never fabricate or assume unverified data — say "insufficient evidence" instead
### Step 5 — Synthesize Output
- **Conclusion first** — Lead with the most important finding or recommendation, then expand
- **Cite every data point** with `[1]`, `[2]`, etc., so the reader can verify
- **Be honest about uncertainty** — If evidence is limited, say so; do not force a conclusion
- End with a full source list
---
## Contradiction and Uncertainty Handling
When you encounter any of the following during research, **do not silently resolve it — surface it to the user:**
| Situation | Action |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| Sources contradict each other on key data | Present both claims with sources, explain possible reasons, ask user which direction to prioritize |
| A critical piece of information cannot be verified | State what you found and what is missing, ask if the user wants to proceed or dig deeper |
| The scope is ambiguous or too broad | Ask a scoping question before investing effort |
| Research is turning up very little | Report what you found so far, ask if the user can provide additional context or alternative keywords |
| User's assumption appears to be incorrect | Politely flag the discrepancy with evidence, ask for confirmation before proceeding |
**Format for follow-up questions:**
> ⚠️ **Needs clarification:** [concise description of the issue]
>
> **Options:**
> 1. [Option A]
> 2. [Option B]
>
> Which would you prefer, or would you like me to handle it differently?
---
## Error Handling
When a tool fails, follow this protocol — **never silently fail or fabricate content:**
| Error | Action |
|-------|--------|
| `search.py` returns empty results | Retry with rephrased keywords or different language, up to 3 attempts. If still empty, inform user and suggest alternative search terms. |
| `web.py` extraction fails (anti-bot, paywall, timeout) | Inform user the page is inaccessible. Try searching for a cached or alternative version. |
| `youtube.py` / `yt-dlp` fails | Check URL format. If "Sign in to confirm you're not a bot" or timeout: suggest enabling TUN mode proxy, or trying `--cookies-from-browser chrome`, or using a Bilibili alternative. Report the specific error to user. |
| `ffmpeg.py` fails | Report the error message. Check input format compatibility. Suggest alternative format if applicable. |
| Any unknown error | Run `doctor` to diagnose, report findings to user, do not guess. |
**Core principle:** If a tool fails and you cannot recover, tell the user what happened, what you tried, and suggest next steps. Never pretend it succeeded.
---
## Output Format
**Strict portable Markdown only.** The output must render correctly in any Markdown editor (GitHub, Obsidian, Typora, VS Code, etc.).
### Rules
1. **No HTML tags** — no `<br>`, `<div>`, `<table>`, `<sub>`, `<sup>`, or any HTML whatsoever
2. **Table cells must be single-line plain text** — no line breaks, no nested lists, no multi-line content inside a cell
3. If content does not fit single-line table cells, **use a list instead of a table**
4. Use blank lines before and after headings, tables, code blocks, and block quotes to ensure correct parsing
5. Do not use indented code blocks — always use fenced code blocks with triple backticks
### Formatting Toolkit
| Element | Usage |
| ------------------- | ------------------------------------- |
| **Bold** | Key conclusions, important numbers |
| Lists (`-` or `1.`) | Pros/cons, steps, explanations |
| `✅ ❌ ⚠️` | Supported / not supported / caution |
| `> quote block` | Direct quotes from sources |
| `` `inline code` `` | Tool names, commands, technical terms |
### Table Example (Use Only When Appropriate)
Tables are for **comparing multiple items with short single-line values:**
```markdown
| Product | Price | Offline | Rating |
| ------- | ----- | ------- | ------ |
| A | $99 | ✅ | 4.5/5 |
| B | $199 | ❌ | 4.0/5 |
| C | Free | ✅ | 3.5/5 |
```
**Do not use tables when:** content is single-column, cells need multi-line text, or structure requires nesting.
### Source Citations
Inline: `[1]`, `[2]`, etc.
At the end:
```markdown
## Sources
[1] [Title](URL) — Key data description
[2] [Title](URL)
```
---
## Context Management
- **Long content (>2000 words):** Summarize key information after extraction; do not paste raw content into the response
- **Subtitles:** Download to disk by default — only load into context when the user explicitly asks for content analysis (e.g. "summarize this video", "extract info about X")
- **Multiple pages:** Synthesize and integrate findings; do not stack raw page dumps
---
## CLI Tools Reference
> 📁 **Working directory:** All commands run from `~/.agents/skills/skilless/`.
> The `cd ~/.agents/skills/skilless/ &&` prefix is shown in full for each command to ensure correct execution.
### Search (Exa AI)
```bash
cd ~/.agents/skills/skilless/ && uv run scripts/search.py "your query"
cd ~/.agents/skills/skilless/ && uv run scripts/search.py "your query" 10
```
### Web Reader (Jina Reader)
```bash
cd ~/.agents/skills/skilless/ && uv run scripts/web.py <url>
```
### Video / Transcript Extractor
**`youtube.py`** — One-step subtitle + metadata extraction (recommended for most cases):
```bash
cd ~/.agents/skills/skilless/ && uv run scripts/youtube.py "<url>"
```
**`yt-dlp` direct** — Advanced usage (custom formats, audio-only, subtitle listing):
```bash
cd ~/.agents/skills/skilless/ && uv run yt-dlp "URL"
cd ~/.agents/skills/skilless/ && uv run yt-dlp --list-subs "URL"
cd ~/.agents/skills/skilless/ && uv run yt-dlp --write-subs --write-auto-subs "URL"
cd ~/.agents/skills/skilless/ && uv run yt-dlp -x --audio-format mp3 "URL"
```
Supported platforms (1700+ via yt-dlp): YouTube, Bilibili, TikTok, Twitter/X, Twitch, Vimeo, Dailymotion, Niconico, Rumble, Odysee, SoundCloud, Reddit, Instagram, Facebook, and many more.
**Download path rules:**
- **Specific project directory** (e.g. `~/codes/my-project/`) → download to current working directory
- **Home directory (`~`)** or **empty path** → download to `~/Downloads/`
- **Never download to `/tmp`** — requires special permissions, files may auto-delete
**YouTube troubleshooting:**
- "Sign in to confirm you're not a bot" or timeout → enable TUN mode proxy, or try `--cookies-from-browser chrome`, or use Bilibili as alternative
### FFmpeg (Media Converter)
```bash
cd ~/.agents/skills/skilless/ && uv run scripts/ffmpeg.py <input> <output>
cd ~/.agents/skills/skilless/ && uv run scripts/ffmpeg.py video.mkv output.mp4
cd ~/.agents/skills/skilless/ && uv run scripts/ffmpeg.py audio.wav output.mp3
cd ~/.agents/skills/skilless/ && uv run scripts/ffmpeg.py input.mp4 output.mp4 -crf 28
```
Supports all common media formats (mp4, mkv, mp3, wav, flac, webm, avi, mov, etc.)
---
## Cross-References
- **Need a detailed report?** → After completing research, invoke `skilless.ai-writing` to produce professional reports, articles, documentation, or any structured written content from your findings
- **Research goal unclear?** → Invoke `skilless.ai-brainstorming` to define scope, clarify questions, and explore approaches before starting a deep investigation 章节与文件索引
按说明文件中的顺序排列。
路由表
研究深度
第 1 步 — 定义范围
第 2 步 — 制定研究计划(L3 强制,L2 推荐)
步骤 3 — 执行每维度(多轮搜索)
文件/命令 -> search.py · web.py · youtube.py · yt-dlp · ffmpeg.py · todo · tasks · todowrite
内容校验值 -> 817852de0289
当前原文的自动摘译,尚未人工审校。
路由表
触发词 · 工具 · 目的搜索、查找、查找 ·
search.py· Web、文档、新闻查找读取、获取、获取页面 ·web.py· 提取页面文本下载、提取、字幕、转录 ·youtube.py/yt-dlp· 视频字幕和元数据转换、压缩、编码、ffmpeg ·ffmpeg.py· 媒体格式转换研究深度
并非每个请求都需要进行全面调查。根据复杂程度选择合适的深度,或者不清楚时询问用户。 “Round” = 并行工具调用的一个周期。单轮可以并行触发 3-5 次搜索/读取。回合是连续的——每一轮都建立在您在上一轮中学到的知识的基础上。级别 · 何时使用 · 最省力 L1 — 快速查找 · 单一事实、定义、简单问题 · 1 轮,1-2 次搜索