forked from Gitlink/gitlink-cli
153 lines
7.1 KiB
Markdown
153 lines
7.1 KiB
Markdown
---
|
||
name: gitlink-project-bootstrap
|
||
version: 1.0.0
|
||
description: "项目一键初始化编排：从一句话项目描述出发，串联创建仓库 → 生成 README/LICENSE/CI 配置 → 初始化 label/milestone/member → 创建首批 Issue → 配置 webhook，实现端到端自动化。"
|
||
metadata:
|
||
requires:
|
||
bins: ["gitlink-cli"]
|
||
orchestrates:
|
||
- gitlink-repo
|
||
- gitlink-label
|
||
- gitlink-milestone
|
||
- gitlink-member
|
||
- gitlink-webhook
|
||
- gitlink-issue
|
||
- gitlink-onboarding
|
||
cliHelp: "gitlink-cli --help"
|
||
---
|
||
|
||
# gitlink-project-bootstrap（项目一键初始化编排）
|
||
|
||
**CRITICAL — 开始前必须先阅读 [`../gitlink-shared/SKILL.md`](../gitlink-shared/SKILL.md)，认证/权限/API 注意事项。**
|
||
**CRITICAL — 本 Skill 几乎全是写入操作（建仓库/建文件/加成员），每一步执行前务必先确认用户意图。**
|
||
**CRITICAL — GitLink 操作只能用 gitlink-cli。禁止用 gh（GitHub CLI）操作 GitLink 资源。**
|
||
**CRITICAL — 失败后不自动 `repo +delete` 回滚，必须用户授权才清理。**
|
||
|
||
---
|
||
|
||
## 工作流总览
|
||
|
||
```mermaid
|
||
flowchart TD
|
||
A[用户一句话需求] --> S1[Step1 🤖AI需求解析<br/>提取项目名/语言/描述/成员]
|
||
S1 --> CONF1{用户确认初始化清单?}
|
||
CONF1 -->|否| S1
|
||
CONF1 -->|是| S2[Step2 创建仓库骨架<br/>repo+create + create-file×3]
|
||
S2 --> S3[Step3 初始化协作体系<br/>label+create / milestone+create / member+batch-add]
|
||
S3 --> S4[Step4 🤖AI推荐首批Issue<br/>issue+create ×N]
|
||
S4 --> S5[Step5 配置自动化<br/>webhook+create + webhook+test]
|
||
S5 --> S6[Step6 🤖AI输出初始化报告<br/>调 onboarding 生成新人文档]
|
||
S6 --> DONE[完成]
|
||
```
|
||
|
||
---
|
||
|
||
## 编排的子 Skill
|
||
|
||
| 子 Skill | 职责 | 调用时机 |
|
||
|---|---|---|
|
||
| gitlink-repo | 创建仓库、写入 README/LICENSE/CI 文件 | Step2 |
|
||
| gitlink-label | 初始化标签体系（bug/feature/doc...） | Step3 |
|
||
| gitlink-milestone | 创建首个里程碑（Sprint 1 / MVP） | Step3 |
|
||
| gitlink-member | 批量添加初始成员 | Step3 |
|
||
| gitlink-issue | 创建首批 Issue | Step4 |
|
||
| gitlink-webhook | 配置 CI/webhook 回调 | Step5 |
|
||
| gitlink-onboarding | 生成新人引导文档 | Step6 |
|
||
|
||
---
|
||
|
||
## 详细步骤
|
||
|
||
### Step 1: 🤖AI 需求解析（AI 判断点）
|
||
|
||
- 🤖AI 判断点：从用户一句话提取并生成「初始化清单」：
|
||
- 项目名（name）
|
||
- 描述（description）
|
||
- 语言/技术栈（决定 README/CI 模板）
|
||
- 可见性（private 默认）
|
||
- 成员列表（user_id 或 login）
|
||
- 缺省字段需明确标注「(推断)」，不得静默补全。
|
||
- 纯命令（核验身份/补全成员 ID）：
|
||
- `gitlink-cli user +me` — 当前操作者
|
||
- `gitlink-cli search +users -k <姓名>` — 反查用户 ID
|
||
- ⚠️强制确认：把完整清单出示给用户，确认或修改后才进入 Step2。
|
||
|
||
### Step 2: 创建仓库骨架（纯命令 + 🤖AI 生成内容）
|
||
|
||
- 纯命令（建仓库）：
|
||
- `gitlink-cli repo +create --name <name> --description "<desc>" --private <true|false>`
|
||
- 🤖AI 判断点：根据语言生成 README.md / LICENSE / CI 配置内容（如 Python→pytest 模板、Go→go build 模板）。
|
||
- ⚠️写入命令（逐个创建文件，每个都需确认）：
|
||
- `gitlink-cli repo +create-file --owner <owner> --repo <name> --filepath README.md --content "<内容>" --message "docs: add README"`
|
||
- `gitlink-cli repo +create-file --owner <owner> --repo <name> --filepath LICENSE --content "<MIT...>" --message "docs: add LICENSE"`
|
||
- `gitlink-cli repo +create-file --owner <owner> --repo <name> --filepath .gitlink-ci.yml --content "<CI配置>" --message "ci: add pipeline config"`
|
||
|
||
### Step 3: 初始化协作体系（纯命令）
|
||
|
||
- 标签体系（🤖AI 推荐配色）：
|
||
- `gitlink-cli label +create --owner <owner> --repo <name> --name bug --color "#d73a4a"`
|
||
- `gitlink-cli label +create --owner <owner> --repo <name> --name feature --color "#a2eeef"`
|
||
- `gitlink-cli label +create --owner <owner> --repo <name> --name documentation --color "#0075ca"`
|
||
- 里程碑：
|
||
- `gitlink-cli milestone +create --owner <owner> --repo <name> --name "Sprint 1"`
|
||
- 成员（批量）：
|
||
- `gitlink-cli member +batch-add --owner <owner> --repo <name> --user-ids <id1,id2,id3> --dry-run` — 先预览
|
||
- 确认后去掉 `--dry-run` 正式添加
|
||
|
||
### Step 4: 🤖AI 推荐首批 Issue（AI 判断点 + 写入命令）
|
||
|
||
- 🤖AI 判断点：根据项目类型推荐 3-5 个初始 Issue（如"搭建项目结构""配置 CI""编写使用文档""冒烟测试"）。
|
||
- ⚠️写入命令（确认后逐条创建）：
|
||
- `gitlink-cli issue +create --owner <owner> --repo <name> --title "搭建项目结构" --body "<描述>" --label <label>`
|
||
|
||
### Step 5: 配置自动化（纯命令）
|
||
|
||
- ⚠️写入命令：
|
||
- `gitlink-cli webhook +create --owner <owner> --repo <name> --url <回调URL> --events push,merge_request`
|
||
- `gitlink-cli webhook +test --owner <owner> --repo <name> --id <webhook_id>` — 测试连通性
|
||
|
||
### Step 6: 🤖AI 输出初始化报告（AI 判断点）
|
||
|
||
- 调子 Skill：`gitlink-onboarding` — 生成新人上手文档段落。
|
||
- 🤖AI 判断点：汇总输出初始化报告：
|
||
- 仓库地址、可见性
|
||
- 已创建文件清单（README/LICENSE/CI）
|
||
- 标签数、里程碑、成员数
|
||
- 首批 Issue 列表
|
||
- Webhook 配置与测试结果
|
||
- 可选建议：`gitlink-cli repo +info --owner <owner> --repo <name>` 复核仓库状态。
|
||
|
||
---
|
||
|
||
## 错误处理与回滚
|
||
|
||
- **逐步熔断**：关键命令（repo +create、repo +create-file、milestone +create）失败，立即停止后续步骤。
|
||
- **不自动删除**：本 Skill **不**自动 `repo +delete`，失败后由用户决定是否回滚。
|
||
- **部分失败汇总**：成员添加、Issue 创建、Webhook 测试的个别失败不阻塞，统一在 Step6 报告列出。
|
||
|
||
---
|
||
|
||
## Agent 触发示例
|
||
|
||
**用户**："帮我初始化一个 Python 的数据分析项目 data-analysis-demo，成员有小王和小李，先私有。"
|
||
|
||
**Agent**：
|
||
1. Step1（🤖AI）：解析 → 项目名 `data-analysis-demo`，语言 Python，成员含小王小李，私有 → 出示清单等待确认。
|
||
2. 用户确认后：
|
||
- `repo +create --name data-analysis-demo --description "..." --private true`
|
||
- 🤖 生成 README.md / LICENSE(MIT) / .gitlink-ci.yml(python pytest) → 三个 `repo +create-file`。
|
||
3. `label +create`（bug/feature/docs 三色）；`milestone +create --name "MVP"`；`member +batch-add --user-ids <小王,小李> --dry-run` → 确认 → 正式添加。
|
||
4. 🤖 推荐 5 条 Issue（环境脚手架/数据加载器/CI 联调/文档/冒烟测试）→ 确认 → 逐条 `issue +create`。
|
||
5. 询问 Webhook URL → `webhook +create` + `webhook +test`。
|
||
6. 调 onboarding 生成新人文档，输出初始化报告。
|
||
|
||
---
|
||
|
||
## 反模式（禁止行为）
|
||
|
||
- ❌ 未确认初始化清单就执行写入命令。
|
||
- ❌ 编造本文件未列出的命令（如 `repo +bootstrap`、`issue +bulk-create`）。
|
||
- ❌ 用 `gh`、`curl` 绕过 gitlink-cli。
|
||
- ❌ 静默补全缺失字段而不告知用户。
|
||
- ❌ 失败后自动 `repo +delete` 清理（必须用户授权）。
|