القائمة
对外部项目进行深度调研分析，产出结构化报告。当用户提到'调研 XXX 项目'、'分析 XXX'、'对比 XXX 和我们的项目'、'研究一下 XXX 的架构/设计'等意图时加载此 skill。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/hwj123hwj/pi-go --skill researchيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | research |
| description | 对外部项目进行深度调研分析，产出结构化报告。当用户提到'调研 XXX 项目'、'分析 XXX'、'对比 XXX 和我们的项目'、'研究一下 XXX 的架构/设计'等意图时加载此 skill。 |
调研开始前，先明确三个关键信息。如果用户没有明确说明，主动询问：
full：完整调研报告（包含所有章节）quick：快速扫描，只出核心发现和迁移建议compare：聚焦对比分析，突出差异和借鉴点不要先做信息收集计划再执行——直接开始，边收集边判断。
收集策略（按优先级）：
find 目录树 + 关键文件阅读，理解代码组织信息获取方式：
gh CLI（gh repo view、gh api、gh browse）Read、grep、find信息饱和判断：当连续 2-3 轮阅读不再产生新的重要发现时，进入分析阶段。不要为了"完整"而无限收集。
按以下维度分析目标项目（根据调研侧重点取舍）：
默认情况下，调研报告写入 docs/research/ 目录，文件名格式：{项目名}-{侧重点}.md
例如：
docs/research/Codex-hooks-analysis.mddocs/research/aider-architecture-compare.mddocs/research/cursor-agent-design.md产出报告必须遵循以下结构（quick 类型可省略标注为可选的章节）：
# {项目名} 调研报告 — {侧重点}
> 调研日期：{YYYY-MM-DD}
> 来源：{GitHub 仓库地址 / 其他来源}
> 调研目标：{一句话说明为什么调研这个项目}
---
## 1. 概述
### 项目定位
| 项目 | 角色 | 技术栈 | 定位 |
|------|------|--------|------|
| {目标项目} | | | |
| pi-go | 我们的 Agent 框架 | Go | 通用 Agent 底座 + coding-agent 应用层 |
### 核心发现摘要
> 3-5 条最重要的发现，每条一句话。
---
## 2. 架构分析
### 整体架构
{架构图 + 分层说明}
### 核心抽象
{关键接口 / 类型 / 模式的设计分析}
### 数据流
{请求从输入到输出的完整路径}
---
## 3. 功能分析
### 功能清单
{核心功能列表，标注创新程度}
### 亮点特性
{值得深入学习的 2-3 个特性，附代码片段或设计说明}
---
## 4. 与 pi-go 对比
### 架构理念对比
| 维度 | {目标项目} | pi-go | 评价 |
|------|-----------|-------|------|
| | | | |
### 功能覆盖对比
| 功能 | {目标项目} | pi-go | 差距评估 |
|------|-----------|-------|----------|
| | | | |
### pi-go 的优势
{pi-go 做得更好的地方——必须要有，不要只写差距}
---
## 5. 迁移建议
### 优先级排序
| 优先级 | 特性/设计 | 迁移难度 | 预期收益 | 实现路径 |
|--------|----------|----------|----------|----------|
| P0 | | | | |
| P1 | | | | |
| P2 | | | | |
### 实施路线图
{按时间顺序的迁移计划，每个阶段有明确交付物}
---
## 6. 详细参考
### 关键文件索引
| 文件路径 | 职责 | 值得关注的点 |
|----------|------|-------------|
| | | |
### 参考资料
- {链接列表}
docs/research/：外部项目的原始调研报告，强调“我看到了什么”docs/decisions/：基于一个或多个调研报告，再结合 pi-go 当前状态得出的采纳判断，强调“我们现在准备怎么做”如果用户要的是：
research/decisions/pi-go 项目路径：/Users/weijian/Desktop/develop/test/pi/pi-go
调研开始前必须先读取 {pi-go路径}/docs/PROJECT_CONTEXT.md，获取 pi-go 的架构、核心能力、技术栈、关键文件等对比基准信息。这样调研时不需要反复读 pi-go 源码，直接以该文档作为对比参照。
如果发现该文档内容与实际代码不一致（架构变更后未更新），调研结束后顺手更新它。
报告和 docs/README.md 的更新路径也是基于 pi-go 项目路径：
{pi-go路径}/docs/research/{项目名}-{侧重点}.md{pi-go路径}/docs/README.md报告完成前自查：