关于 ark-research
用于在实施前收集技术证据的研究技能。它通过网页搜索、仓库检查、处理受阻内容和本地工作区整理研究,并要求以来源支持结论。
主要功能
- 01搜索文档与规范
- 02克隆并检查 GitHub 仓库
- 03处理受阻或无法访问的内容
- 04在本地研究工作区保存发现
- 05要求多项证据并注明来源
适用场景
- 01实施前比较技术方案
- 02检查仓库示例与架构
- 03为技术建议收集证据
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ mckinsey/ agents-at-scale-ark --skill ark-research安装后在 Claude Code 中输入/ark-research确认已加载。
详细介绍
Ark Research
在实施之前,研究技术方案并收集证据。
研究流程
1. 先进行网络搜索
始终先通过网络搜索查找:
- 官方文档
- GitHub 仓库
- 博客文章和教程
- 协议规范(PDF、RFC)
2. 检查 GitHub 仓库
GitHub 原始内容通常会被屏蔽。克隆仓库进行检查:
cd /tmp
git clone https://github.com/owner/repo.git
cat /tmp/repo/README.md
查找:
- README 文档
- 代码示例
- 架构模式
- 依赖项和要求
3. 处理被屏蔽的内容
如果无法加载某个网站:
- 请用户粘贴相关内容
- 请求提供 PDF 或规范文档
- 如果需要查看视觉内容,请用户提供截图
示例提示词:
“我找到了一项相关资源:[URL],但无法访问。你能否粘贴关键内容或提供 PDF?”
4. 本地研究工作区
将研究结果保存在 ./scratch/research/,供审阅:
mkdir -p ./scratch/research
保存:
- 克隆仓库的摘要
- 代码片段
- 架构图
- 对比笔记
5. 证据要求
推荐方案前至少需要 2–3 条数据点:
- 有活跃维护的 GitHub 仓库
- 文档或规范
- 实际使用示例
- 社区反馈(问题、讨论)
如果证据不足,请寻求指导:
“我只找到一条关于这种方法的参考资料。你能否提供更多资源,或进一步说明需求?”
输出格式
始终为研究结果提供来源:
## Research: [Topic]
### Option 1: [Solution Name]
- **Source**: [URL or repo link]
- **Pros**: ...
- **Cons**: ...
- **Evidence**: [What confirms this works]
### Option 2: [Solution Name]
...
### Recommendation
Based on [N] sources, I recommend [Option] because...
### Sources
- [Title](URL)
- [Repo](GitHub URL) - cloned and examined
- [Spec](URL) - user provided
使用示例
用户:“研究在 MCP 服务中进行终端录制的方案”
- 网络搜索:“terminal recording library node typescript”
- 查找 GitHub 仓库 → 克隆到 /tmp 并检查
- 查找 asciinema、VHS、xterm.js
- 在 ./scratch/research/terminal-recording.md 中比较方案
- 为每种方案提供 2–3 个来源
评论
支持 Markdown