1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | pavedpath-code（项目自述名称：PavedPath Code） | GitHub API |
| 作者/维护者 | Jia-Ethan（独立开发者，同账号下另有 claude-keysmith、codex-keysmith 等同类工程工具） | GitHub API |
| 来源链接 | https://github.com/Jia-Ethan/pavedpath-code | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars | 336 | GitHub API |
| Forks | 27 | GitHub API |
| 最新更新 | 2026-06-30（无语义化版本号，按日期记录变更） | GitHub API |
| 安装方式 | 复制安装指令交给智能体自动接入，或手动克隆到对应 agent 的 skills 目录 | 仓库 README |
2. 功能介绍与亮点
pavedpath-code 是一个专注“代码与工程问题”的 Skill：当 Agent 遇到报错、依赖冲突、框架/API 用法不确定、构建部署失败等问题时，引导它先去 GitHub 找“别人已经走通的路径”，再把最强证据转译成本地最小改动，而非凭空猜测或重复造轮子。
核心流程：界定问题（症状、报错文本、版本号）→ 用 gh CLI 检索 Issue/PR/Release/代码 → 按问题匹配度（而非单纯 Star 数）排序证据 → 提炼可复用模式与风险边界 → 只改动本地真正需要适配的部分 → 用测试/构建/复现命令验证后才宣称完成；证据不足时明确告知这是推断而非已验证方案。
亮点是全程以 GitHub CLI 作为一手检索工具而非网页爬取，且明文写出安全边界：不访问未经用户授权的私有仓库，不保存 token、cookie 或凭据。
3. 适用场景
固定分类：工程效率与代码质量
遇到运行时报错、构建/部署失败、依赖冲突时找已验证修复路径；实现功能前想参考成熟项目真实用法；技术选型时横向比较候选项目成熟度。受益人群：日常使用编码 Agent 的初中级开发者、独立开发者。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——安装指令明确列出 Claude Code
- Codex：✅ 原生支持——默认安装路径为
~/.codex/skills/，并附专属接口元数据 - OpenClaw：❓ 未验证
- Hermes Agent：❓ 未验证
（README 另提到兼容 Cursor Agent、ChatGPT Agent，但不在本站四个目标生态内，仅供参考。）
5. 推荐理由
把工程排错、依赖选型这类问题转成搜索 GitHub 已验证方案再落地的可执行路径，比让 Agent 凭训练知识臆测更可靠，也比人工逐个翻 Issue 更省时间。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 336 Star / 27 Fork；有独立开发者提交的功能请求 PR，另被第三方 Skill 目录 skillrank 收录，但尚未形成多平台的活跃讨论 |
| 可用性 | 8 | README、SKILL.md、CHANGELOG、MIGRATION 文档齐全，提供可直接复制给智能体的安装话术；依赖用户本机已配置 GitHub CLI（gh），需要一次性认证，非纯复制即用；最近一次更新为 2026-06-30 |
| 安全性 | 8 | 纯提示词/方法论型 Skill，不自带可执行脚本；检索动作全部通过用户已授权的 gh CLI 完成；明文禁止保存 token/cookie/私仓内容；提交记录为真实功能迭代，未见刷星或 SEO 操纵痕迹 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令/权限范围 | 不自带脚本，依赖用户已认证的 gh CLI 执行只读检索（搜索仓库/Issue/PR/代码），未见越权写权限 |
| ② 联网外发 | 仅通过 gh 调用 GitHub 官方 API，无第三方外发 |
| ③ API Key/凭据 | 复用用户本机既有的 gh 登录态，SKILL.md 明确禁止保存 token、cookie、私仓内容或凭据 |
| ④ 可疑指令 | 未发现提示注入或隐藏指令，行文透明可审计 |
| ⑤ 作者信誉 | 独立开发者，同账号下有多个同类工程工具仓库，提交记录均为真实功能迭代，无刷星/SEO 操纵措辞 |
| ⑥ License | MIT，清晰 |
| ⑦ 最近维护 | 最近一次提交 2026-06-30，约三周前，维护活跃 |
综合评分 = 三项均值 = 7.3
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 pavedpath-code 的差异 |
|---|---|---|
| Understand-Anything | 把任意代码库自动生成可探索知识图谱 | 面向“看懂自己手头这个代码库”，pavedpath-code 面向“外部 GitHub 上别人怎么解决同类问题” |
| GitHub 官方 MCP Server | 让 Agent 直接读写 Issue/PR/代码库 | 是通用 GitHub 读写接口，不带证据排序方法论；pavedpath-code 封装了“先界定问题→按证据强度排序→最小化本地转译→验证优先”的完整研究流程 |
| Agent 自带网页搜索 | 泛用型信息检索能力 | 缺少针对代码问题的证据分级标准（issue/PR/release 优先于泛搜索）、缺少提炼模板与“证据不足就如实说明”的纪律 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；GitHub 仓库收到过一位西语开发者提交的功能请求 PR，显示已有独立第三方参与共建。
9. 其他补充
仓库提供中文与英文双语文档；已被第三方 Skill 目录 skillrank 收录。
10. 安装使用方式
- 方式一（推荐）：把 README 中提供的现成安装话术复制给 Claude Code / Codex，智能体会自动阅读文档并完成安装。
- 方式二（手动）：
git clone到对应 Agent 的 skills 目录，如 Codex CLI 下的~/.codex/skills/pavedpath-code。 - 前置依赖：本机需已安装并完成
gh auth login认证的 GitHub CLI。 - 安装后无需重启，直接在对话中描述工程报错或实现选型问题即可触发。
11. 注意事项
- 依赖 GitHub CLI（
gh）本机认证，未配置时检索能力受限； - 定位收窄在“代码/工程问题”，不涵盖非工程类调研；
- 目前为单一维护者项目，外部贡献仍在积累中；
- 无语义化版本号，变更记录按日期追踪。