From 93d695d1b31955bf734e9fadff42128e5bed6b46 Mon Sep 17 00:00:00 2001 From: zkevin <2930705585@qq.com> Date: Tue, 23 Jun 2026 15:56:57 +0800 Subject: [PATCH] Add gitlink-code-insight skill: interactive dashboard for all shortcuts New skill that generates an HTML dashboard showcasing all 69 gitlink-cli shortcuts organized into 14 categories with search and collapsible UI. Co-Authored-By: Claude Opus 4.7 --- doc/dashboard.html | 64 ++++++++++ skills/README.md | 28 ++++- skills/gitlink-code-insight/SKILL.md | 178 +++++++++++++++++++++++++++ 3 files changed, 265 insertions(+), 5 deletions(-) create mode 100644 doc/dashboard.html create mode 100644 skills/gitlink-code-insight/SKILL.md diff --git a/doc/dashboard.html b/doc/dashboard.html new file mode 100644 index 00000000..7e5dc42a --- /dev/null +++ b/doc/dashboard.html @@ -0,0 +1,64 @@ + + + + + +gitlink-cli 功能全景 + + + +
+

gitlink-cli 功能全景

+

所有 Shortcuts 分类展示 · 点击分类展开 · 点击命令查看示例

+
14
分类
69
Shortcuts
+
+
+
📦仓库管理8 个命令▶
repo +list公开仓库列表▶
gitlink-cli repo +list --user zhangsan
repo +info公开仓库详情▶
gitlink-cli repo +info --owner Gitlink --repo forgeplus
repo +create需认证创建仓库▶
gitlink-cli repo +create --name my-project --description "项目描述"
repo +fork需认证Fork 仓库▶
gitlink-cli repo +fork --owner Gitlink --repo forgeplus
repo +delete需认证删除仓库（不可逆）▶
gitlink-cli repo +delete --owner myuser --repo old-project
repo +batch-create需认证批量创建仓库▶
gitlink-cli repo +batch-create --from repos.csv
repo +batch-update需认证批量更新仓库▶
gitlink-cli repo +batch-update --from updates.csv
repo +add-member需认证添加仓库成员▶
gitlink-cli repo +add-member --owner myuser --repo myrepo --user newmember --role developer
🌿分支管理5 个命令▶
branch +list公开分支列表▶
gitlink-cli branch +list --owner Gitlink --repo forgeplus
branch +create需认证创建分支▶
gitlink-cli branch +create --name feature/new-feature
branch +delete需认证删除分支（不可逆）▶
gitlink-cli branch +delete --name feature/old-feature
branch +protect需认证保护分支▶
gitlink-cli branch +protect --name main
branch +unprotect需认证取消保护▶
gitlink-cli branch +unprotect --name main
🐛Issue 管理7 个命令▶
issue +list公开Issue 列表▶
gitlink-cli issue +list --owner Gitlink --repo forgeplus --state open
issue +view公开Issue 详情▶
gitlink-cli issue +view --owner Gitlink --repo forgeplus --number 4
issue +create需认证创建 Issue▶
gitlink-cli issue +create --owner myuser --repo myrepo --title "Bug: 登录失败" --body "复现步骤"
issue +update需认证更新 Issue▶
gitlink-cli issue +update --number 4 --title "新标题" --body "更新描述"
issue +close需认证关闭 Issue▶
gitlink-cli issue +close --number 4
issue +batch-close需认证批量关闭 Issue▶
gitlink-cli issue +batch-close --numbers 123,124 --dry-run
issue +comment需认证添加评论▶
gitlink-cli issue +comment --number 4 --body "已修复"
🔀Pull Request9 个命令▶
pr +list公开PR 列表▶
gitlink-cli pr +list --owner Gitlink --repo forgeplus --state open
pr +view公开PR 详情▶
gitlink-cli pr +view --id 3
pr +create需认证创建 PR▶
gitlink-cli pr +create --title "feat: 新功能" --head feature/x --base master
pr +merge需认证合并 PR▶
gitlink-cli pr +merge --id 3 --method squash
pr +close需认证关闭 PR▶
gitlink-cli pr +close --id 3
pr +files公开变更文件列表▶
gitlink-cli pr +files --id 3
pr +diff公开查看提交列表▶
gitlink-cli pr +diff --id 3
pr +comment需认证PR 评论▶
gitlink-cli pr +comment --id 3 --body "LGTM"
pr +review需认证代码审查▶
gitlink-cli pr +review --id 3 --event COMMENT --body "整体 LGTM"
🚀版本发布4 个命令▶
release +list公开发布列表▶
gitlink-cli release +list --owner Gitlink --repo forgeplus
release +view公开发布详情▶
gitlink-cli release +view --id <version_id>
release +create需认证创建发布▶
gitlink-cli release +create --tag v1.0.0 --name "v1.0.0" --target master
release +delete需认证删除发布（不可逆）▶
gitlink-cli release +delete --id <version_id>
📖Wiki 管理5 个命令▶
wiki +list公开Wiki 页面列表▶
gitlink-cli wiki +list --owner Gitlink --repo forgeplus
wiki +view公开查看页面内容▶
gitlink-cli wiki +view --owner Gitlink --repo forgeplus --title "Home"
wiki +create需认证创建页面▶
gitlink-cli wiki +create --owner myuser --repo myrepo --title "API 文档" --file ./api.md
wiki +update需认证更新页面▶
gitlink-cli wiki +update --owner myuser --repo myrepo --title "设计文档" --add "新内容"
wiki +delete需认证删除页面▶
gitlink-cli wiki +delete --owner myuser --repo myrepo --title "废弃页面"
⚙️CI/CD4 个命令▶
ci +builds需认证构建列表▶
gitlink-cli ci +builds --owner myuser --repo myrepo
ci +logs需认证构建日志▶
gitlink-cli ci +logs --build 42 --stage 1 --step 1
ci +restart需认证重启构建▶
gitlink-cli ci +restart --build 42
ci +stop需认证停止构建▶
gitlink-cli ci +stop --build 42
🔔Webhook7 个命令▶
webhook +list需认证Webhook 列表▶
gitlink-cli webhook +list --owner myuser --repo myrepo
webhook +info需认证Webhook 详情▶
gitlink-cli webhook +info --owner myuser --repo myrepo --id 123
webhook +events公开支持的事件类型▶
gitlink-cli webhook +events
webhook +create需认证创建 Webhook▶
gitlink-cli webhook +create --url https://example.com/hook --events push
webhook +update需认证更新 Webhook▶
gitlink-cli webhook +update --id 123 --events push,pull_request
webhook +test需认证测试 Webhook▶
gitlink-cli webhook +test --id 123 --event push
webhook +delete需认证删除 Webhook▶
gitlink-cli webhook +delete --id 123
🏢组织管理5 个命令▶
org +list公开组织列表▶
gitlink-cli org +list
org +info公开组织详情▶
gitlink-cli org +info --id Gitlink
org +members公开成员列表▶
gitlink-cli org +members --id Gitlink
org +create需认证创建组织▶
gitlink-cli org +create --name my-org --description "我的组织"
org +batch-add需认证批量添加成员▶
gitlink-cli org +batch-add --id my-org --users "user1,user2"
👤用户与搜索4 个命令▶
user +me需认证当前登录用户▶
gitlink-cli user +me
user +info公开用户详情▶
gitlink-cli user +info --login zhangsan
search +repos公开搜索仓库▶
gitlink-cli search +repos --keyword "machine learning"
search +users公开搜索用户▶
gitlink-cli search +users --keyword "zhangsan"
🛡️安全与合规6 个命令▶
compliance +scan公开全量扫描▶
gitlink-cli compliance +scan
compliance +license公开许可证合规检查▶
gitlink-cli compliance +license
compliance +deps公开依赖许可证检查▶
gitlink-cli compliance +deps
compliance +secrets公开敏感信息扫描▶
gitlink-cli compliance +secrets
compliance +exposure公开PII 与暴露面扫描▶
gitlink-cli compliance +exposure
compliance +vocab公开敏感词汇扫描▶
gitlink-cli compliance +vocab
👋新人引导1 个命令▶
onboard +welcome需认证添加引导评论▶
gitlink-cli onboard +welcome --issues "3,7,15"
👥团队管理3 个命令▶
team +list公开团队列表▶
gitlink-cli team +list --org my-org
team +create需认证创建团队▶
gitlink-cli team +create --org my-org --name dev-team
team +add-member需认证添加成员▶
gitlink-cli team +add-member --org my-org --team dev-team --user newmember
📊贡献报告1 个命令▶
contrib +report公开贡献统计报告▶
gitlink-cli contrib +report --owner myuser --repo myrepo
+
生成时间: 2026-06-23 15:54 · 运行 /code-insight 重新生成
+ + + \ No newline at end of file diff --git a/skills/README.md b/skills/README.md index 3fe125f5..a5988805 100644 --- a/skills/README.md +++ b/skills/README.md @@ -128,11 +128,23 @@ skills/ │ └── SKILL.md # PM 操作指南 ├── gitlink-workflow/ # AI 自动化工作流 │ └── SKILL.md # 工作流模板（Issue 分类、PR Review、Release Notes） -└── gitlink-issue-triage/ # Issue 自动分类（NEW） - ├── SKILL.md # AI Agent 主入口 - ├── README.md # 使用说明 - ├── references/ # 分析算法 + 应用手册 - └── examples/ # 批量/单 Issue 工作流示例 +├── gitlink-issue-triage/ # Issue 自动分类 +│ ├── SKILL.md # AI Agent 主入口 +│ ├── README.md # 使用说明 +│ ├── references/ # 分析算法 + 应用手册 +│ └── examples/ # 批量/单 Issue 工作流示例 +├── gitlink-webhook/ # Webhook 管理 +│ └── SKILL.md # Webhook 操作指南 +├── gitlink-compliance/ # 安全与合规 +│ └── SKILL.md # 许可证、敏感信息、PII 扫描 +├── gitlink-onboard/ # 新人引导 +│ └── SKILL.md # Good First Issue 识别与欢迎评论 +├── gitlink-team/ # 团队管理 +│ └── SKILL.md # 团队操作指南 +├── gitlink-contrib/ # 贡献报告 +│ └── SKILL.md # 贡献统计与报告 +└── gitlink-code-insight/ # 功能全景 + └── SKILL.md # 全部 Shortcuts 分类展示 ``` --- @@ -164,6 +176,12 @@ skills/ | **gitlink-changelog** | Release Notes / Changelog 生成 | 自动收集 commits/PR/Issue，生成结构化版本说明 | | **gitlink-issue-triage** | Issue 自动分类 | 自动判定 tracker/priority/labels，关联 Issue，生成审计报告 | | **gitlink-workflow** | AI 工作流 | Issue 分类、PR Review、仓库初始化、Sprint 报告 | +| **gitlink-webhook** | Webhook 管理 | `webhook +list`, `webhook +create`, `webhook +test` | +| **gitlink-compliance** | 安全与合规 | `compliance +scan`, `compliance +secrets`, `compliance +license` | +| **gitlink-onboard** | 新人引导 | `onboard +welcome` | +| **gitlink-team** | 团队管理 | `team +list`, `team +create`, `team +add-member` | +| **gitlink-contrib** | 贡献报告 | `contrib +report` | +| **gitlink-code-insight** | 功能全景 | 全部 Shortcuts 分类索引，含说明和示例 | --- diff --git a/skills/gitlink-code-insight/SKILL.md b/skills/gitlink-code-insight/SKILL.md new file mode 100644 index 00000000..ab7a69c3 --- /dev/null +++ b/skills/gitlink-code-insight/SKILL.md @@ -0,0 +1,178 @@ +--- +name: gitlink-code-insight +version: 4.0.0 +description: "功能全景仪表盘：当用户想了解 gitlink-cli 有哪些功能时，生成交互式 HTML 页面并打开浏览器展示。" +metadata: + requires: + bins: ["python3"] +--- + +# gitlink-code-insight（功能全景仪表盘） + +## 触发条件 + +用户问以下问题时触发： +- "gitlink-cli 有哪些功能" +- "帮我生成一个功能展示页面" +- "我想浏览所有可用命令" + +## 执行步骤 + +1. 根据下方 Shortcuts 数据生成单文件 HTML +2. 写入 `doc/dashboard.html` +3. 用 `python3 -c "import webbrowser; webbrowser.open('file://$(pwd)/doc/dashboard.html')"` 打开 + +## 页面要求 + +- 暗色主题（GitHub Dark 风格） +- 顶部：标题 + 统计数字（分类数、Shortcuts 总数）+ 搜索框 +- 主体：分类卡片列表，每个卡片可折叠展开 + - 卡片标题：图标 + 分类名 + 命令计数 + - 展开后显示该分类下所有 shortcut 行 + - 每行：命令（等宽蓝色）+ 认证标签（绿色=需认证，蓝色=公开）+ 描述 + - 点击 shortcut 行展开代码示例 +- 搜索框实时过滤（按命令名和描述匹配），无匹配时隐藏整个分类 +- 纯 CSS + 原生 JS，无外部依赖 + +--- + +## Shortcuts 数据 + +### 一、仓库管理 📦 + +| 命令 | 描述 | 认证 | 示例 | +|------|------|------|------| +| `repo +list` | 仓库列表 | 否 | `gitlink-cli repo +list --user zhangsan` | +| `repo +info` | 仓库详情 | 否 | `gitlink-cli repo +info --owner Gitlink --repo forgeplus` | +| `repo +create` | 创建仓库 | 是 | `gitlink-cli repo +create --name my-project --description "项目描述"` | +| `repo +fork` | Fork 仓库 | 是 | `gitlink-cli repo +fork --owner Gitlink --repo forgeplus` | +| `repo +delete` | 删除仓库（不可逆） | 是 | `gitlink-cli repo +delete --owner myuser --repo old-project` | +| `repo +batch-create` | 批量创建仓库 | 是 | `gitlink-cli repo +batch-create --from repos.csv` | +| `repo +batch-update` | 批量更新仓库 | 是 | `gitlink-cli repo +batch-update --from updates.csv` | +| `repo +add-member` | 添加仓库成员 | 是 | `gitlink-cli repo +add-member --owner myuser --repo myrepo --user newmember --role developer` | + +### 二、分支管理 🌿 + +| 命令 | 描述 | 认证 | 示例 | +|------|------|------|------| +| `branch +list` | 分支列表 | 否 | `gitlink-cli branch +list --owner Gitlink --repo forgeplus` | +| `branch +create` | 创建分支 | 是 | `gitlink-cli branch +create --name feature/new-feature` | +| `branch +delete` | 删除分支（不可逆） | 是 | `gitlink-cli branch +delete --name feature/old-feature` | +| `branch +protect` | 保护分支 | 是 | `gitlink-cli branch +protect --name main` | +| `branch +unprotect` | 取消保护 | 是 | `gitlink-cli branch +unprotect --name main` | + +### 三、Issue 管理 🐛 + +| 命令 | 描述 | 认证 | 示例 | +|------|------|------|------| +| `issue +list` | Issue 列表 | 否 | `gitlink-cli issue +list --owner Gitlink --repo forgeplus --state open` | +| `issue +view` | Issue 详情 | 否 | `gitlink-cli issue +view --owner Gitlink --repo forgeplus --number 4` | +| `issue +create` | 创建 Issue | 是 | `gitlink-cli issue +create --owner myuser --repo myrepo --title "Bug: 登录失败" --body "复现步骤"` | +| `issue +update` | 更新 Issue | 是 | `gitlink-cli issue +update --number 4 --title "新标题" --body "更新描述"` | +| `issue +close` | 关闭 Issue | 是 | `gitlink-cli issue +close --number 4` | +| `issue +batch-close` | 批量关闭 Issue | 是 | `gitlink-cli issue +batch-close --numbers 123,124 --dry-run` | +| `issue +comment` | 添加评论 | 是 | `gitlink-cli issue +comment --number 4 --body "已修复"` | + +### 四、Pull Request 🔀 + +| 命令 | 描述 | 认证 | 示例 | +|------|------|------|------| +| `pr +list` | PR 列表 | 否 | `gitlink-cli pr +list --owner Gitlink --repo forgeplus --state open` | +| `pr +view` | PR 详情 | 否 | `gitlink-cli pr +view --id 3` | +| `pr +create` | 创建 PR | 是 | `gitlink-cli pr +create --title "feat: 新功能" --head feature/x --base master` | +| `pr +merge` | 合并 PR | 是 | `gitlink-cli pr +merge --id 3 --method squash` | +| `pr +close` | 关闭 PR | 是 | `gitlink-cli pr +close --id 3` | +| `pr +files` | 变更文件列表 | 否 | `gitlink-cli pr +files --id 3` | +| `pr +diff` | 查看提交列表 | 否 | `gitlink-cli pr +diff --id 3` | +| `pr +comment` | PR 评论 | 是 | `gitlink-cli pr +comment --id 3 --body "LGTM"` | +| `pr +review` | 代码审查 | 是 | `gitlink-cli pr +review --id 3 --event COMMENT --body "整体 LGTM"` | + +### 五、版本发布 🚀 + +| 命令 | 描述 | 认证 | 示例 | +|------|------|------|------| +| `release +list` | 发布列表 | 否 | `gitlink-cli release +list --owner Gitlink --repo forgeplus` | +| `release +view` | 发布详情 | 否 | `gitlink-cli release +view --id ` | +| `release +create` | 创建发布 | 是 | `gitlink-cli release +create --tag v1.0.0 --name "v1.0.0" --target master` | +| `release +delete` | 删除发布（不可逆） | 是 | `gitlink-cli release +delete --id ` | + +### 六、Wiki 管理 📖 + +| 命令 | 描述 | 认证 | 示例 | +|------|------|------|------| +| `wiki +list` | Wiki 页面列表 | 否 | `gitlink-cli wiki +list --owner Gitlink --repo forgeplus` | +| `wiki +view` | 查看页面内容 | 否 | `gitlink-cli wiki +view --owner Gitlink --repo forgeplus --title "Home"` | +| `wiki +create` | 创建页面 | 是 | `gitlink-cli wiki +create --owner myuser --repo myrepo --title "API 文档" --file ./api.md` | +| `wiki +update` | 更新页面 | 是 | `gitlink-cli wiki +update --owner myuser --repo myrepo --title "设计文档" --add "新内容"` | +| `wiki +delete` | 删除页面 | 是 | `gitlink-cli wiki +delete --owner myuser --repo myrepo --title "废弃页面"` | + +### 七、CI/CD ⚙️ + +| 命令 | 描述 | 认证 | 示例 | +|------|------|------|------| +| `ci +builds` | 构建列表 | 是 | `gitlink-cli ci +builds --owner myuser --repo myrepo` | +| `ci +logs` | 构建日志 | 是 | `gitlink-cli ci +logs --build 42 --stage 1 --step 1` | +| `ci +restart` | 重启构建 | 是 | `gitlink-cli ci +restart --build 42` | +| `ci +stop` | 停止构建 | 是 | `gitlink-cli ci +stop --build 42` | + +### 八、Webhook 🔔 + +| 命令 | 描述 | 认证 | 示例 | +|------|------|------|------| +| `webhook +list` | Webhook 列表 | 是 | `gitlink-cli webhook +list --owner myuser --repo myrepo` | +| `webhook +info` | Webhook 详情 | 是 | `gitlink-cli webhook +info --owner myuser --repo myrepo --id 123` | +| `webhook +events` | 支持的事件类型 | 否 | `gitlink-cli webhook +events` | +| `webhook +create` | 创建 Webhook | 是 | `gitlink-cli webhook +create --url https://example.com/hook --events push` | +| `webhook +update` | 更新 Webhook | 是 | `gitlink-cli webhook +update --id 123 --events push,pull_request` | +| `webhook +test` | 测试 Webhook | 是 | `gitlink-cli webhook +test --id 123 --event push` | +| `webhook +delete` | 删除 Webhook | 是 | `gitlink-cli webhook +delete --id 123` | + +### 九、组织管理 🏢 + +| 命令 | 描述 | 认证 | 示例 | +|------|------|------|------| +| `org +list` | 组织列表 | 否 | `gitlink-cli org +list` | +| `org +info` | 组织详情 | 否 | `gitlink-cli org +info --id Gitlink` | +| `org +members` | 成员列表 | 否 | `gitlink-cli org +members --id Gitlink` | +| `org +create` | 创建组织 | 是 | `gitlink-cli org +create --name my-org --description "我的组织"` | +| `org +batch-add` | 批量添加成员 | 是 | `gitlink-cli org +batch-add --id my-org --users "user1,user2"` | + +### 十、用户与搜索 👤 + +| 命令 | 描述 | 认证 | 示例 | +|------|------|------|------| +| `user +me` | 当前登录用户 | 是 | `gitlink-cli user +me` | +| `user +info` | 用户详情 | 否 | `gitlink-cli user +info --login zhangsan` | +| `search +repos` | 搜索仓库 | 否 | `gitlink-cli search +repos --keyword "machine learning"` | +| `search +users` | 搜索用户 | 否 | `gitlink-cli search +users --keyword "zhangsan"` | + +### 十一、安全与合规 🛡️ + +| 命令 | 描述 | 认证 | 示例 | +|------|------|------|------| +| `compliance +scan` | 全量扫描 | 否 | `gitlink-cli compliance +scan` | +| `compliance +license` | 许可证合规检查 | 否 | `gitlink-cli compliance +license` | +| `compliance +deps` | 依赖许可证检查 | 否 | `gitlink-cli compliance +deps` | +| `compliance +secrets` | 敏感信息扫描 | 否 | `gitlink-cli compliance +secrets` | +| `compliance +exposure` | PII 与暴露面扫描 | 否 | `gitlink-cli compliance +exposure` | +| `compliance +vocab` | 敏感词汇扫描 | 否 | `gitlink-cli compliance +vocab` | + +### 十二、新人引导 👋 + +| 命令 | 描述 | 认证 | 示例 | +|------|------|------|------| +| `onboard +welcome` | 添加引导评论 | 是 | `gitlink-cli onboard +welcome --issues "3,7,15"` | + +### 十三、团队管理 👥 + +| 命令 | 描述 | 认证 | 示例 | +|------|------|------|------| +| `team +list` | 团队列表 | 否 | `gitlink-cli team +list --org my-org` | +| `team +create` | 创建团队 | 是 | `gitlink-cli team +create --org my-org --name dev-team` | +| `team +add-member` | 添加成员 | 是 | `gitlink-cli team +add-member --org my-org --team dev-team --user newmember` | + +### 十四、贡献报告 📊 + +| 命令 | 描述 | 认证 | 示例 | +|------|------|------|------| +| `contrib +report` | 贡献统计报告 | 否 | `gitlink-cli contrib +report --owner myuser --repo myrepo` |