github-project-replication

GitHub 开源项目自动化复现

当你收到用户"复现 GitHub 项目"相关的任务时，按照本技能定义的系统化六阶段工作流，从项目理解到稳定运行，全程自动化执行。

---

核心原则

1. 必须先调用 brainstorming — 每次任务执行必须先调用 brainstorming 技能进行前期构思和分析，不得跳过此步骤。这帮助你在动手之前全面理解项目目标和潜在挑战。
2. 必须用 planning-with-files-zh 做追踪 — 调用 planning-with-files-zh 技能进行任务文件化追踪，该技能会创建 task_plan.md、findings.md、progress.md 三个核心追踪文件，让整个复现过程有迹可循、可回溯。
3. 规范统一由 skill-standard-harness 管理 — 操作层面的公共规范（如 GitHub 仓库获取规范、Markdown 输出规范等）由 skill-standard-harness 统一维护，本技能不再重复定义。

---

GitHub 仓库获取规范

复现项目的第一步是获取目标仓库的代码。请调用 skill-standard-harness 技能并读取 references/github-access-standard.md，按照其中的四级优先级规范执行获取操作。

---

目录说明

github-project-replication/
├── SKILL.md    ← 本文件：六阶段工作流定义
├── references/ ← 预留：本技能自身的参考文档（当前无内容）
└── scripts/    ← 预留：本技能自身的辅助脚本（当前无内容）

注意：本技能涉及的公共规范（GitHub 仓库获取、Markdown 输出）统一存放在 skill-standard-harness/references/，不在此目录重复维护。

---

六阶段工作流

阶段一：初始化 → 阶段二：项目理解 → 阶段三：复现搭建
                                     ↓ (循环迭代)
                             阶段四：运行评估 ←——┘
                                     ↓
                             阶段五：循环迭代
                                     ↓
                             阶段六：任务收尾

阶段一：技能调用与初始化

触发条件：接收到 "复现 GitHub 项目" 相关任务时立即进入此阶段。

执行步骤：

1. 调用 brainstorming — 对目标项目进行初步分析构思。思考：

   • 这个项目做什么的？它的核心价值是什么？
   • 它依赖哪些技术栈和环境？
   • 复现它可能遇到哪些主要挑战？
   • 需要哪些前置条件（如 API 密钥、数据库、特定 OS）？

2. 调用 planning-with-files-zh — 初始化三个追踪文件：

   • task_plan.md — 拆解为可执行的任务清单
   • findings.md — 预留研究笔记空间
   • progress.md — 准备记录操作日志

3. 解析用户输入 — 从用户消息中提取：

   • 目标 GitHub 仓库 URL（如 https://github.com/user/repo）
   • 或本地项目路径
   • 任何附加要求（如特定分支、自定义配置）

获取目标仓库代码 — 调用 skill-standard-harness 技能，按照 references/github-access-standard.md 中的四级优先级规范获取源码。将获取过程和结果记录到 progress.md。

阶段二：MCP 服务调用与项目理解

目标：快速全面地了解目标项目的代码架构，为复现工作奠定基础。

执行步骤：

1. 分析项目代码结构（如果 CodeGraph MCP 服务可用）：
   • 索引目标项目的代码库
   • 获取项目结构统计信息（实体数量、文件数、模块关系等）
   • 进行符号搜索和上下文探索
   • 分析依赖关系和调用链
   • 为什么：这让你在动手前就对代码的骨架有全局认知，避免在搭建时走弯路