القائمة
分析 spec-driven 仓库，提取核心知识。当用户想要分析 GitHub 仓库、提取项目文档、了解项目架构、翻译项目文档时触发。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | spec-analyzer |
| description | 分析 spec-driven 仓库，提取核心知识。当用户想要分析 GitHub 仓库、提取项目文档、了解项目架构、翻译项目文档时触发。 |
分析 spec-driven 仓库，提取以下三类核心信息：
# 分析远程仓库（自动 clone 并翻译为中文）
/spec-analyzer https://github.com/gsd-build/get-shit-done
# 分析本地仓库
/spec-analyzer /path/to/local/repo
# 指定输出目录和分析深度
/spec-analyzer https://github.com/xxx/yyy --output ./docs --depth deep
# 保留英文原文，不翻译
/spec-analyzer https://github.com/xxx/yyy --lang en
| 参数 | 说明 | 默认值 |
|---|---|---|
--output, -o | 输出目录 | ./analyzed/ |
--depth, -d | 分析深度 (quick/deep) | quick |
--lang, -l | 输出语言 (zh-CN/en) | zh-CN |
--translate-only | 只翻译不分析 | false |
--keep-repo, -k | 保留 clone 的仓库 | false |
owner/repocd /tmp && git clone https://github.com/owner/repo.git
直接使用，跳过 clone。
默认翻译为中文（--lang zh-CN），在 clone 后立即执行。
| 优先级 | 文件 | 说明 |
|---|---|---|
| 必须 | README.md | 项目入口文档 |
| 必须 | docs/**/*.md | 所有文档 |
| 高 | CLAUDE.md | Claude Code 配置（如有） |
| 高 | *.md spec 文件 | PROJECT.md, REQUIREMENTS.md, ROADMAP.md, STATE.md, PLAN.md |
| 中 | agents/**/*.md | Agent 定义文件（如有） |
| 中 | commands/**/*.md | 命令文档（如有） |
Wave（波次）./translated/<repo-name>/原文：
## Getting Started
First, install the dependencies:
译文：
## 快速开始
首先，安装依赖：
输出目录结构：
./analyzed/<repo-name>/
├── README_CN.md # 翻译后的 README
├── docs/ # 翻译后的文档
│ └── **/*.md
├── analysis/ # 分析报告
│ ├── overview.md
│ ├── problems.md
│ ├── solutions.md
│ └── technical-points.md
└── structure.json # 结构化数据
# {项目名称} 概览
## 一句话简介
{项目的一句话描述}
## 核心价值
{这个项目解决了什么核心问题}
## 目标用户
{这个项目是为谁设计的}
## 快速开始
{如何快速上手使用}
# {项目名称} 问题分析
## 1. 核心问题
> 一句话描述这个项目要解决的核心问题
**问题描述**: {详细描述}
**影响范围**: {谁受影响，影响多大}
## 2. 背景与现状
### 2.1 之前的做法
{描述在没有这套系统之前，用户是如何处理类似问题的}
### 2.2 现有方案的痛点
| 痛点 | 描述 | 根本原因 | 影响 |
|------|------|----------|------|
| {痛点1} | {描述} | {为什么存在} | {对用户的影响} |
| {痛点2} | {描述} | {为什么存在} | {对用户的影响} |
## 3. 问题根源分析
{分析这些问题的根本原因}
# {项目名称} 解决方案
## 1. 核心思路
> 一句话描述这套系统的核心思路
{详细说明}
## 2. 工作流程
### 流程图
{使用 Mermaid 绘制流程图}
### 步骤说明
1. **步骤1**: {说明}
2. **步骤2**: {说明}
...
## 3. 关键设计决策
| 决策 | 原因 | 权衡 |
|------|------|------|
| {决策1} | {为什么这样选择} | {放弃了什么} |
| {决策2} | {为什么这样选择} | {放弃了什么} |
## 4. 与现有方案对比
| 维度 | 现有方案 | 本系统 |
|------|----------|--------|
| {维度1} | {描述} | {描述} |
# {项目名称} 技术要点
## 1. 核心概念
| 概念 | 定义 | 用途 |
|------|------|------|
| {概念1} | {定义} | {用途} |
| {概念2} | {定义} | {用途} |
## 2. 关键实现
### 2.1 {实现1}
**目的**: {这个实现解决什么问题}
**原理**: {工作原理}
**代码示例**:
```{language}
{代码}
...
{描述数据如何在系统中流动}
{系统提供了哪些扩展能力}
## 示例
### 示例 1: 分析 GitHub 仓库（默认翻译）
```bash
/spec-analyzer https://github.com/gsd-build/get-shit-done --depth deep
执行步骤：
/tmp/get-shit-done/./analyzed/get-shit-done/README_CN.md 等/spec-analyzer https://github.com/xxx/yyy --translate-only
只翻译核心文件，不生成分析报告。
/spec-analyzer https://github.com/xxx/yyy --lang en
跳过翻译步骤，直接分析。
在分析 spec-driven 仓库时，特别关注以下内容：
PROJECT.md, REQUIREMENTS.md, ROADMAP.md, STATE.md, PLAN.md 等的作用/tmp/<repo-name>/--keep-repo：保留仓库，用户手动清理# 手动清理所有临时分析的仓库
rm -rf /tmp/<repo-name>/
# 或者使用通配符清理（谨慎使用）
rm -rf /tmp/analyzed-*
可能原因：
解决方案：
# 1. 设置代理
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890
# 2. 如果是私有仓库，先手动 clone，然后使用本地路径
/spec-analyzer /path/to/local/repo
# 3. 完成后取消代理
git config --global --unset http.proxy
git config --global --unset https.proxy
优化建议：
--depth deep 获取更多上下文使用 --translate-only 参数：
/spec-analyzer https://github.com/xxx/yyy --translate-only