AgentSkillsCN

project-analyzer

Claude Code 插件项目分析专家。分析目标项目的优点、设计思路，与当前项目流程对比，判断是否需要借鉴。只借鉴真正需要的，避免盲目照搬。

中文原作
SKILL.md
--- frontmatter
name: project-analyzer
description: Claude Code 插件项目分析专家。分析目标项目的优点、设计思路，与当前项目流程对比，判断是否需要借鉴。只借鉴真正需要的，避免盲目照搬。
disable-model-invocation: false

项目分析专家

分析目标项目的优点、设计思路，与当前项目流程对比，判断是否需要借鉴。只借鉴真正需要的，避免盲目照搬。

使用场景

  • •想了解其他插件项目的设计思路
  • •想找出当前项目的不足和优化点
  • •想学习其他项目的最佳实践（但不是照搬）

核心原则

不是：目标有什么 → 都要借鉴

而是：目标为什么这样设计 → 当前是否需要 → 只借鉴需要的

分析框架

四步分析法

  1. •优点是什么 - 具体功能点
  2. •为什么会这样设计 - 背后的思路/原理
  3. •当前流程是否需要 - 从整体判断，不是从单个功能
  4. •做不做 - 只对需要借鉴的做计划，不需要的不做

决策原则

情况决策理由
当前已实现❌ 不需要不做重复工作
不适合当前项目❌ 不建议照搬可能破坏一致性
需要但成本高🔜 计划中评估后再决定
需要且成本低✅ 建议做立即可实施

分析流程

Step 1: 克隆项目

bash
cd /tmp
git clone [仓库地址] project-analysis
cd project-analysis

Step 2: 提取优点和设计思路

分析每个优点时，需要回答：

问题目的
这个优点是什么？明确功能点
为什么会这样设计？理解背后的原理
这个设计解决了什么问题？判断是否通用
有什么适用条件？判断是否适合当前项目

分析方法：

  1. •读取 README.md 了解项目定位
  2. •列出所有核心功能
  3. •分析每个功能的设计思路
  4. •提取背后的原理

Step 3: 当前项目对比

读取当前项目配置，对比每个优点：

bash
ls agents/
ls skills/
ls commands/
ls hooks/

对比维度：

维度分析内容
设计思路对比目标为什么这样设计 vs 当前项目怎么做的
实现方式对比技术实现差异
流程对比属于哪个阶段，当前流程是否覆盖
成本收益对比实现成本 vs 预期收益

Step 4: 负面效果分析

对于每个潜在的借鉴点，分析盲目添加可能带来的问题：

负面效果说明
复杂度增加新功能增加维护成本
功能冗余与现有功能重复
一致性破坏风格/模式不匹配
学习成本用户需要学习新概念
冲突风险与现有功能产生冲突

Step 5: 决策和计划

markdown
## 决策结论

| 优点 | 设计思路 | 是否借鉴 | 理由 |
|------|---------|---------|------|
| xxx | xxx | ✅ 建议做 | xxx |
| xxx | xxx | ❌ 不需要 | 理由 |
| xxx | xxx | ⚠️ 计划中 | 理由 |

## 实施计划

### 需要做的
1. **优点 1**：理由
   - 实现方式：xxx
   - 预期收益：xxx

### 不需要做的
1. **优点 2**：理由
   - 原因：xxx
   - 负面效果：xxx

输出报告模板

markdown
# 项目分析报告：[项目名称]

## 一、目标项目概述

- **GitHub 地址**：[URL]
- **Star 数**：xxx
- **主要功能**：xxx
- **定位**：通用插件 / 特定领域插件

## 二、优点分析

### 2.1 优点列表

| 优点 | 设计思路 | 解决了什么问题 |
|------|---------|--------------|
| xxx | xxx | xxx |

### 2.2 设计思路详解

[对每个优点深入分析：为什么会这样设计]

## 三、与当前项目对比

### 3.1 设计思路对比

| 优点 | 目标项目设计 | 当前项目做法 | 是否需要 |
|------|------------|------------|---------|
| xxx | xxx | xxx | ✅/❌ |

### 3.2 流程对比

| 流程阶段 | 目标项目 | 当前项目 |
|---------|---------|---------|
| 需求 | xxx | ✅/⚠️/❌ |
| 规划 | xxx | ✅/⚠️/❌ |

## 四、负面效果分析

| 潜在借鉴点 | 可能带来的问题 | 风险等级 |
|-----------|--------------|---------|
| xxx | xxx | 高/中/低 |

## 五、决策结论

### ✅ 建议做的
1. **优点 1**
   - 理由：xxx
   - 实现方式：xxx
   - 预期收益：xxx

### ❌ 不需要做的
1. **优点 2**
   - 理由：xxx
   - 原因：xxx

### ⚠️ 计划中的
1. **优点 3**
   - 理由：xxx
   - 待评估：xxx

## 六、实施计划

[只列出"建议做"的内容]

输出要求

  1. •保存报告到：docs/plans/YYYY-MM-DD-[project-name]-analysis.md
  2. •不要修改任何现有文件
  3. •只做只读分析

关键原则

  1. •不是照抄 - 判断是否需要，不是全部复制
  2. •思路优先 - 理解为什么这样设计，不是只看做了什么
  3. •流程视角 - 从整体流程判断，不是从单个功能
  4. •负面分析 - 分析盲目添加可能带来的问题
  5. •明确取舍 - 说不借鉴的理由和说不借鉴的理由同样重要