Agent Skills
返回列表
💻

一键项目结构化分析

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_a3e29d98/harness-project-intake-a3e29d98。

技能介绍

要解决什么问题

刚进一个陌生仓库,你往往需要的是结论而不是 cat README.md 的全文:这个项目做什么、用什么运行时和框架、目录怎么组织、怎么构建运行、最近是否还在维护。Project Intake 面向「项目概览 / 分析 README / 技术栈是什么」这类诉求,在只读前提下把零散文件信息收成一张可读的项目卡。

如何工作

技能按成本递进顺序采集,通常 6~8 次工具调用内完成,不必反复扫盘:

  1. 根目录 ls:判断单包、Monorepo 还是脚本型项目
  2. 读取包清单(package.json / Cargo.toml / go.mod / pyproject.toml 等):语言、依赖与脚本
  3. 提炼 README.md 要点:描述、约束、构建命令
  4. find 浅层目录骨架
  5. git log 最近提交:活跃度与版本线索
  6. rg 定位入口与关键模块

输出固定为结构化项目卡(身份、技术栈、架构骨架、配置、已知约束与活跃度等维度),采集过程对用户不可见。信息缺失时写 Not found / Not configured,禁止猜测版本或框架;缺清单时用扩展名推断并标注 Inferred (no package manifest)。Monorepo 会标注子包语言/工具链矩阵,区分共享与独立工具链。

适用边界

  • 不触发:用户只要某个文件原文(例如只要 package.json 内容)、或已在本项目工作且无需重分析
  • 质量前提:应尽量覆盖包清单、README、入口文件;任一缺失则在对应维度标注 Incomplete information
  • README 过时或配置缺失时,在 Known Constraints 中说明;卡片末尾会提示分析基于当前工作区状态

使用场景

  • clone 后第一次打开仓库,需要在改代码前先弄清用途、构建命令和目录分层
  • 用户说「分析一下 README」,希望得到摘要式项目卡而不是 README 全文粘贴
  • 接手他人维护的 Node/Go/Rust 混合仓库,要快速列出各子包的清单与语言矩阵
  • 准备给下游 bootstrap 或规范检查喂上下文,需要先产出身份、约束与架构骨架的结构化卡片

适合人员

  • 刚接入新代码库的外包或新人,要在首日提交前搞清怎么跑、入口在哪、依赖管什么
  • Review 陌生 fork 的维护者,PR 前需要对照实际清单与 README 是否一致、有无过时说明
  • 负责梳理多仓库的内平台或架构同学,需要统一格式的项目身份与技术栈快照
  • 在 Claude Code 里用 harness 工作流的人,需要 Layer 0 项目卡再交给 bootstrap 等下游技能