罗斯蒙德开源项目快速上手

价格

以上为公开标价。你的组织可能有协议价，以控制台显示的价格为准。

如何使用

1. 1

   为组织安装

   开通即安装：组织固定使用开通时的版本（当前为 1.0.0）。升级到新版本需要取消后重新开通。

2. 2

   创建凭证

   客户端使用组织凭证读取；绑定到数字人后，数字人使用绑定凭证按需加载。请求中携带：

   Authorization: Bearer $ZGI_MARKET_KEY

3. 3

   读取清单与安装包

   清单列出版本、文件和校验值；安装包是一个 zip 文件。

   curl "https://market-api.zgi.im/v1/market/skills/project-explanation/manifest" \
     -H "Authorization: Bearer $ZGI_MARKET_KEY"

   curl "https://market-api.zgi.im/v1/market/skills/project-explanation/package" \
     -H "Authorization: Bearer $ZGI_MARKET_KEY" \
     -o project-explanation.zip

   读取清单和下载安装包不计入用量。下载后请用响应头中的 SHA-256 校验文件。

技能说明

名称

开源项目快速上手

说明

【罗斯蒙德开源项目快速上手】南京罗斯蒙德基于已交付项目沉淀的开源项目快速上手场景：默认场景是「讲解整个项目」：给一个本地代码文件夹或仓库地址就直接开讲——先30秒最小扫描、不打断不等回复，一路产出必出五件套：一句话结论（值不值得用）、代码架构（分层+模块依赖+主调用链+扩展机制）、三级能力清单（带高频度与代码位置）、可运行带注释Demo、四段式踩坑点与上手全流程指南，每条结论挂 路径:行号。采用「假设确认表」告知而非卡流程——写一行假设就往下干，用户没回应也照出全量报告，把多轮沟通压缩为零。用户带着需求来时才额外启用「需求满足度评估」分支：先以批处理澄清表把需求歧义问清（≤5问/轮、带默认选项、≤3轮）并冻结需求基线，再逐项做代码审查，给出能否实现、修改位置（文件:行号）、工作量（档位+人日+估算依据）与不涵盖功能的补充方案。三条路由：只讲项目走主线，项目+需求走主线打底+评估，已有单点诉求只出评估。支持分析本地代码路径，无本地路径时联网检索官方文档与源码。触发词：讲解这个项目、解读这个仓库、这个代码是干嘛的、看看这个项目、快速上手、看源码、这个项目怎么用、代码架构、项目结构、核心功能、能力清单、生成 demo、写个示例、踩坑点、注意事项、上手指南、源码分析、依赖注入、开源项目、能不能支持、能不能实现、需要改哪里、改哪些地方、工作量多少、需求满足度、功能项评估、缺口分析、二次开发评估、代码审查。

# 开源项目快速上手

## 概述

把一个陌生开源项目变成「能看懂、能跑起来、能改得动、能评估出要投多少人」的状态。

五条核心原则：

1. **讲清楚是主业，问清楚是例外** —— 用户丢了项目就从头讲到尾，一个字不问；只有带需求且需求有歧义时才开口问。假设表是"告知"，输出的同时继续干活，**绝不停下来等回复**。
2. **结论必带出处** —— 每条架构判断、每个能力点都要有 `文件路径:行号` 或文档 URL。没读到的代码不臆测，写"未验证"。
3. **Demo 必须开箱即用** —— 不是片段演示，是能跑起来的东西：含构建文件、配置、依赖、运行步骤、完整注释。
4. **踩坑点要能防问题** —— 每条必须写清「现象 → 原因 → 解决 → 如何避免」。只写"注意版本兼容"这种空话等于没写。
5. **需求有歧义必须先问清** —— 用户带需求来时，理解错了后面全废。**唯一允许多轮追问的环节**，但必须批处理（一次摊开 ≤5 问、每问带默认选项、最多 3 轮），问不清不许开始评估。

## 何时使用 / 何时不用

**用：** **丢一个代码文件夹/仓库让讲解整个项目**（默认场景）、接手陌生开源项目、调研某个库要不要用、需要快速产出可运行示例、要给别人写上手文档、**评估某开源项目能否满足既定需求并估算改造工作量**。

**不用：** 已有项目日常开发、只需要查某个 API 用法（直接看文档更快）、做通用代码规范审查或安全审计（本技能只做**需求驱动**的代码核查，不做全量 review）。

## 入口场景决定走哪条路

**先判断用户属于哪种场景，别一上来就把阶段 R 那套澄清表掏出来。**

| 场景 | 典型说法 | 走什么 | 是否追问 |
|------|----------|--------|----------|
| **A · 讲解整个项目**（最高频） | "帮我看下这个项目""讲解一下这个仓库""这个代码是干嘛的"+ 丢一个文件夹/仓库 | **主线 阶段 0-6**，出完整上手报告（架构 + 能力清单 + Demo + 踩坑 + 指南） | **不追问、不等回复** |
| **B · 项目 + 需求**（同时给） | "看下 XX 能不能做 YY，要改哪里、多久" | 阶段 0-3 打底 + **阶段 R** 出结论 | 仅就需求歧义澄清 |
| **C · 已有单点诉求**（已看过项目） | "这个项目的登录模块能不能换成 LDAP" | 跳到阶段 2/3 取证据 + **阶段 R**，报告只出评估不重出上手报告 | 仅就需求歧义澄清 |

**场景 A 是默认场景。** 用户只是丢了个文件夹让讲项目 —— **老老实实走主线，一个字都不要问，
直接扫描、直接出报告**，假设写在报告头部即可。只有场景 B/C 才启用阶段 R 的澄清与评估。

**路由铁律**：

- 用户**没有提出任何需求/功能项** → **绝不进入阶段 R**，不做任何澄清追问，不许问"你打算用它做什么"
- 用户提了需求 → 阶段 R 才生效；且**主线产出不能因此缩水**（除非用户明确说"只要评估"）

用户一句话里既有项目名又有需求（场景 B）→ **两条都走**：阶段 0-3 打底（拿到架构与能力清单），
阶段 R 出结论。**用户要的是结论，不要因为没跑完七阶段就不给评估结论。**

## 主流程（阶段 0-6）· 场景 A 默认走这条

### 阶段 0 · 最小扫描与假设声明（不等待）

**《假设确认表》是"告知"不是"卡流程"——输出的同时就往下干活，不许停下来等回复。**
（例外：场景 B/C 的需求歧义，走阶段 R 澄清表，见 `references/assumption-form.md`。）

先做最小扫描（读 README / 目录结构 / 构建文件），然后输出《假设确认表》：

```markdown
## 假设声明（不用回复，我已按此开始；有改动随时说）

| 项 | 我的判断 | 依据 | 如需修改请直接改这一行 |
|----|----------|------|------------------------|

• SKILL.md20.9 KiB
• _meta.json112 B
• examples/spring-di/README.md2.3 KiB
• examples/spring-di/demo/README.md2.4 KiB
• examples/spring-di/demo/pom.xml1.7 KiB
• examples/spring-di/demo/src/main/java/com/example/di/DemoApplication.java660 B
• examples/spring-di/demo/src/main/java/com/example/di/client/MockPayClient.java573 B
• examples/spring-di/demo/src/main/java/com/example/di/client/PayClient.java387 B
• examples/spring-di/demo/src/main/java/com/example/di/client/SmsPayClient.java538 B
• examples/spring-di/demo/src/main/java/com/example/di/config/AppConfig.java834 B
• examples/spring-di/demo/src/main/java/com/example/di/controller/OrderController.java1.5 KiB
• examples/spring-di/demo/src/main/java/com/example/di/service/NotifyService.java1.4 KiB
• examples/spring-di/demo/src/main/java/com/example/di/service/OrderService.java787 B
• examples/spring-di/demo/src/main/java/com/example/di/service/ReportService.java948 B
• examples/spring-di/demo/src/main/resources/application.yml230 B
• examples/spring-di/scan_report.json5.1 KiB
• examples/spring-di/上手报告.md12.8 KiB
• references/architecture-analysis.md5.6 KiB
• references/assumption-form.md7.5 KiB
• references/capability-list.md3.0 KiB
• references/demo-generation.md3.5 KiB
• references/pitfalls.md4.2 KiB
• references/quickstart-guide.md3.0 KiB
• references/requirement-fit-assessment.md10.9 KiB
• scripts/check_demo.py8.7 KiB
• scripts/check_fit_report.py6.7 KiB
• scripts/scan_project.py20.9 KiB
• templates/onboarding-report.md5.7 KiB
• templates/requirement-fit-report.md4.9 KiB

来源与审核

审核状态

尚未审核，内容来自上游来源

来源文档

https://api.skillhub.cn/org-0lub9joc/project-explanation

许可证

未说明

审核状态是平台对上架信息的记录，不构成对上游服务质量或可用性的担保。