forked from Gitlink/gitlink-cli
fix: 文档修复 — 端到端工作流说明+新需求构思报告+变更汇总 #7
|
|
@ -0,0 +1,117 @@
|
|||
# 变更说明汇总
|
||||
|
||||
> 本文件汇总 GitLink CLI 智能化能力提升项目所有变更，按子任务分类。
|
||||
> 最后更新：2026-07-07
|
||||
|
||||
---
|
||||
|
||||
## 子任务一：CLI 能力扩展
|
||||
|
||||
### 新增 Shortcut 命令组
|
||||
|
||||
在原有 10 个命令组（branch/ci/common/issue/org/pr/release/repo/search/user）基础上，新增 13 个命令组：
|
||||
|
||||
| 命令组 | 子命令数 | 代码行数 | 单元测试 | 作者 | 说明 |
|
||||
|--------|---------|---------|---------|------|------|
|
||||
| webhook | 20 | 533 | ✅ | Mengz | Webhook 管理（增删改查+测试） |
|
||||
| wiki | 13 | 555 | ✅ | 赵昌 | 仓库 Wiki 页面管理 |
|
||||
| snippet | 9 | 271 | ✅ | 赵昌 | 代码片段管理 |
|
||||
| file | 18 | 490 | ❌ | 刘焱 | 文件管理（上传/下载/批量推送） |
|
||||
| collaborator | 13 | 69 | ✅ | 刘焱 | 协作者管理 |
|
||||
| milestone | 14 | 224 | ❌ | 刘焱 | 里程碑管理 |
|
||||
| commit | 13 | 172 | ❌ | 刘焱 | 提交记录查询 |
|
||||
| template | 10 | 150 | ❌ | 刘焱 | 模板管理（导入/导出） |
|
||||
| label | 11 | 218 | ❌ | 刘焱 | 标签管理 |
|
||||
| dataset | 9 | 123 | ❌ | 刘焱 | 数据集管理 |
|
||||
| tag | 7 | 138 | ✅ | 刘焱 | 标签（Release Tag）管理 |
|
||||
| sshkey | 8 | 96 | ❌ | 刘焱 | SSH 公钥管理 |
|
||||
| attachment | 4 | 53 | ❌ | 刘焱 | 附件管理 |
|
||||
| util | 3 | 46 | ❌ | 刘焱 | 通用工具函数 |
|
||||
|
||||
**合计**：新增 149 个子命令，约 3000 行 Go 代码，6 个命令组配有单元测试。
|
||||
|
||||
### 已有命令组扩展
|
||||
|
||||
对原有命令组也进行了功能增强：
|
||||
- `ci` — 新增 save-yaml、run-pipeline、delete-pipeline 等 DevOps 流水线管理命令
|
||||
- `pr` — 新增 batch-merge、batch-close、version-diff、versions 等批量操作命令
|
||||
- `issue` — 新增 batch-update 批量更新命令
|
||||
- `repo` — 新增 code-stats、contributors-stat 等统计分析命令
|
||||
|
||||
详细变更说明：[webhook-shortcut.md](./webhook-shortcut.md)
|
||||
|
||||
---
|
||||
|
||||
## 子任务二：AI Agent Skills
|
||||
|
||||
### 新增 Skills
|
||||
|
||||
在原有 Skills 基础上，团队新增 16 个自定义 Skill：
|
||||
|
||||
| Skill | 作者 | 说明 |
|
||||
|-------|------|------|
|
||||
| gitlink-community-ops | 赵昌 | 社区运营自动化（Issue 分拣→周报→Release Notes） |
|
||||
| gitlink-quality-gate | 赵昌 | 代码质量门禁（PR 审查→CI 检查→门禁决策） |
|
||||
| gitlink-project-health | 赵昌 | 项目健康度分析 |
|
||||
| gitlink-issue-triage | 赵昌 | Issue 自动分拣 |
|
||||
| gitlink-newcomer-guide | 赵昌 | 新人引导 |
|
||||
| gitlink-pr-deep-review | 赵昌 | PR 深度审查 |
|
||||
| gitlink-research-hotspot | 赵昌 | 科研热点追踪与知识图谱 |
|
||||
| gitlink-research-insight | 赵昌 | 科研项目洞悉 |
|
||||
| gitlink-snippet | 赵昌 | 代码片段 Skill |
|
||||
| gitlink-wiki | 赵昌 | Wiki 管理 Skill |
|
||||
| gitlink-contributor-growth | 刘焱 | 贡献者成长体系 |
|
||||
| gitlink-multi-repo-coordination | 刘焱 | 多仓库协同 |
|
||||
| gitlink-project-bootstrap | 刘焱 | 项目一键初始化 |
|
||||
| gitlink-research-compliance | 曾蔚然 | 科研合规与复现性 |
|
||||
| gitlink-research-matching | 曾蔚然 | 科研协作智能匹配 |
|
||||
| gitlink-research-progress | 曾蔚然 | 科研进度跟踪与预警 |
|
||||
|
||||
每个 Skill 包含：`SKILL.md`（命令参考）+ `examples/`（使用示例）+ `scripts/`（可复现脚本）。
|
||||
|
||||
---
|
||||
|
||||
## 子任务三：端到端自动化工作流
|
||||
|
||||
5 个端到端场景，统一采用"三阶段脚本 + JS 分析引擎"架构：
|
||||
|
||||
| 场景 | 串联脚本 | 分析引擎 | 作者 |
|
||||
|------|---------|---------|------|
|
||||
| 社区运营自动化 | community-ops-full.sh | health-analyze.js | 赵昌 |
|
||||
| 代码质量门禁 | quality-gate-full.sh | scoring-engine.js | 赵昌 |
|
||||
| 项目一键初始化 | project-bootstrap-full.sh | skeleton-gen.js | 刘焱 |
|
||||
| 多仓库协同 | multi-repo-full.sh | dashboard-gen.js | 刘焱 |
|
||||
| 贡献者成长体系 | contributor-growth-full.sh | growth-analyze.js | 刘焱 |
|
||||
|
||||
---
|
||||
|
||||
## 子任务四：科研辅助模块
|
||||
|
||||
5 大科研辅助模块，覆盖科研全生命周期：
|
||||
|
||||
| 模块 | Skill | 功能 |
|
||||
|------|-------|------|
|
||||
| 科研项目洞悉 | gitlink-research-insight | 8 维数据采集 + 4 维评分 |
|
||||
| 热点追踪与知识图谱 | gitlink-research-hotspot | 多关键词搜索 + 实体关系图谱 |
|
||||
| 科研合规与复现性 | gitlink-research-compliance | 三维复现性证据链 |
|
||||
| 科研协作智能匹配 | gitlink-research-matching | 角色匹配 + 缺口识别 |
|
||||
| 科研进度跟踪与预警 | gitlink-research-progress | 6 维动态风险信号 |
|
||||
|
||||
---
|
||||
|
||||
## DevOps 流水线
|
||||
|
||||
4 条建木流水线 YAML 配置：
|
||||
|
||||
| 流水线 | 触发方式 | 文件 |
|
||||
|--------|---------|------|
|
||||
| 构建流水线 | push | `.devops/构建流水线.yml` |
|
||||
| 项目初始化 | 手动 | `.devops/项目初始化流水线.yml` |
|
||||
| 多仓库协同 | 手动 | `.devops/多仓库协同流水线.yml` |
|
||||
| 贡献者成长 | 定时 | `.devops/贡献者成长体系流水线.yml` |
|
||||
|
||||
---
|
||||
|
||||
## 操作中心
|
||||
|
||||
新增 `/gitlink` 斜杠命令作为统一入口，16 项操作上下选择执行。配置文件：`.claude/commands/gitlink.md`
|
||||
BIN
doc/新需求构思报告.docx
BIN
doc/新需求构思报告.docx
Binary file not shown.
|
|
@ -1,7 +1,7 @@
|
|||
# 端到端工作流说明文档
|
||||
|
||||
> 子任务三 · 5 个端到端自动化场景
|
||||
> 最后更新：2026-07-04
|
||||
> 最后更新：2026-07-07
|
||||
|
||||
## 一、总体架构
|
||||
|
||||
|
|
@ -12,7 +12,7 @@
|
|||
```
|
||||
┌─────────────────────────────────────────────────────────┐
|
||||
│ DevOps 流水线层 │
|
||||
│ (6 条建木 YAML · push/PR/定时/手动触发) │
|
||||
│ (4 条建木 YAML · push/定时/手动触发) │
|
||||
├─────────────────────────────────────────────────────────┤
|
||||
│ 端到端编排层 │
|
||||
│ community-ops / quality-gate / project-bootstrap / │
|
||||
|
|
@ -86,7 +86,6 @@ community-ops-full.sh z2_cc gitlink-cli
|
|||
- `skills/gitlink-community-ops/SKILL.md` — 设计规格
|
||||
- `skills/gitlink-community-ops/scripts/community-ops-full.sh` — 串联脚本
|
||||
- `skills/gitlink-community-ops/scripts/health-analyze.js` — 分析引擎
|
||||
- `.devops/社区运营流水线.yml` — DevOps 配置（定时触发）
|
||||
|
||||
## 三、场景二：代码质量门禁
|
||||
|
||||
|
|
@ -104,8 +103,8 @@ quality-gate-full.sh z2_cc gitlink-cli
|
|||
│ ├── Critical / Warning / Suggestion 三级
|
||||
│ └── CodeReview 评分: 100 - Critical×20 - Warning×10 - Suggestion×3
|
||||
│
|
||||
├── Phase 3: CI 检查 (03-ci-check.sh)
|
||||
│ ├── 构建状态
|
||||
├── Phase 3: 本地 CI 检查 (03-local-ci-check.sh)
|
||||
│ ├── 本地 go build 编译验证
|
||||
│ ├── 测试覆盖率
|
||||
│ └── CI 评分: 全通过=100, 有失败=0（一票否决）
|
||||
│
|
||||
|
|
@ -126,8 +125,8 @@ quality-gate-full.sh z2_cc gitlink-cli
|
|||
### 3.3 对应文件
|
||||
|
||||
- `skills/gitlink-quality-gate/SKILL.md`
|
||||
- `skills/gitlink-quality-gate/scripts/quality-gate-full.sh`（378 行）
|
||||
- `.devops/代码质量门禁流水线.yml`（PR 触发）
|
||||
- `skills/gitlink-quality-gate/scripts/quality-gate-full.sh`（80 行）
|
||||
- `skills/gitlink-quality-gate/scripts/03-local-ci-check.sh` — 本地 CI 检查
|
||||
|
||||
## 四、场景三：项目一键初始化
|
||||
|
||||
|
|
@ -158,7 +157,7 @@ project-bootstrap-full.sh
|
|||
### 4.2 对应文件
|
||||
|
||||
- `skills/gitlink-project-bootstrap/SKILL.md`
|
||||
- `skills/gitlink-project-bootstrap/scripts/project-bootstrap-full.sh`（601 行）
|
||||
- `skills/gitlink-project-bootstrap/scripts/project-bootstrap-full.sh`（61 行）
|
||||
- `skills/gitlink-project-bootstrap/scripts/skeleton-gen.js` — 骨架生成引擎
|
||||
- `.devops/项目初始化流水线.yml`（手动触发）
|
||||
|
||||
|
|
@ -189,7 +188,7 @@ multi-repo-full.sh
|
|||
### 5.2 对应文件
|
||||
|
||||
- `skills/gitlink-multi-repo-coordination/SKILL.md`
|
||||
- `skills/gitlink-multi-repo-coordination/scripts/multi-repo-full.sh`（560 行）
|
||||
- `skills/gitlink-multi-repo-coordination/scripts/multi-repo-full.sh`（70 行）
|
||||
- `skills/gitlink-multi-repo-coordination/scripts/dashboard-gen.js` — 看板引擎
|
||||
- `.devops/多仓库协同流水线.yml`（手动触发）
|
||||
|
||||
|
|
@ -229,7 +228,7 @@ contributor-growth-full.sh z2_cc gitlink-cli
|
|||
### 6.3 对应文件
|
||||
|
||||
- `skills/gitlink-contributor-growth/SKILL.md`
|
||||
- `skills/gitlink-contributor-growth/scripts/contributor-growth-full.sh`（642 行）
|
||||
- `skills/gitlink-contributor-growth/scripts/contributor-growth-full.sh`（56 行）
|
||||
- `skills/gitlink-contributor-growth/scripts/growth-analyze.js` — 分析引擎
|
||||
- `.devops/贡献者成长体系流水线.yml`（定时触发）
|
||||
|
||||
|
|
@ -238,12 +237,10 @@ contributor-growth-full.sh z2_cc gitlink-cli
|
|||
| 流水线 | 触发方式 | 对应场景 | 文件 |
|
||||
|--------|----------|----------|------|
|
||||
| 构建流水线 | push | CLI 编译验证 | 构建流水线.yml |
|
||||
| 代码质量门禁 | PR | 场景二 | 代码质量门禁流水线.yml |
|
||||
| 社区运营 | 定时 | 场景一 | 社区运营流水线.yml |
|
||||
| 项目初始化 | 手动 | 场景三 | 项目初始化流水线.yml |
|
||||
| 多仓库协同 | 手动 | 场景四 | 多仓库协同流水线.yml |
|
||||
| 贡献者成长 | 定时 | 场景五 | 贡献者成长体系流水线.yml |
|
||||
|
||||
所有流水线配置 DRY_RUN 默认安全模式，SSH 密钥用 `((work_together.ssh_key))` 密文引用，可在 GitLink DevOps 平台一键复现。
|
||||
社区运营（场景一）和代码质量门禁（场景二）通过手动执行脚本运行，未接入 DevOps 流水线。所有流水线配置 DRY_RUN 默认安全模式，SSH 密钥用 `((work_together.ssh_key))` 密文引用，可在 GitLink DevOps 平台一键复现。
|
||||
|
||||
— 文档完 —
|
||||
|
|
|
|||
Loading…
Reference in New Issue