用途:为 GitHub Projects v2 项目初始化 ghpm 配置,自动发现项目 schema 并生成配置文件。
主要能力:解析项目 URL 或 owner 与编号;校验 gh 认证与访问权限;获取项目字段(含 Status 工作流字段);通过 GraphQL 拉取视图(布局、过滤器、排序、分组);列出项目条目并提取仓库列表;写入 .ghpm/config.json 和 .ghpm/cache.json,创建 .ghpm/sessions,并把 .ghpm/ 加入 .gitignore;可选为 Claude Code 安装会话钩子。
使用方式:以项目 URL(如 https://github.com/orgs/<org>/projects/<number>)为参数;无参数时询问用户提供 URL 或 owner+number。执行前需保证 gh 已认证(gh auth login),并使用 gh project view、gh project field-list、gh api graphql、gh project item-list 等命令完成发现流程,最后按结构写入配置文件。
适用场景:需要把 GitHub Projects v2 接入 ghpm 工作流(分支命名、状态同步、会话记录)的团队或用户。
限制:依赖 GitHub CLI 及 read:project、project 等令牌权限;item-list 使用 --limit 控制总数,无游标分页,超出部分会被静默截断;钩子安装仅在检测到 Claude Code 时为可选,未检测到或拒绝则跳过;资料未提供收费、价格与具体效果信息。