forked from Gitlink/gitlink-cli
feat(workflows): add 5 workflow scripts with bug fixes
Add workflow automation scripts for GitLink CLI: - 01-community-ops: issue triage, weekly reports, release notes - 02-code-quality-gatekeeper: PR review, quality scoring, auto-merge - 03-project-init: repo creation, branch protection, wiki setup - 04-multi-repo-collab: cross-repo dashboard, health monitoring - 05-contributor-growth: AHP-weighted scoring, HTML reports, wiki publish Fixes applied during testing: - common.sh: fix SIGPIPE error in gl_check (use here-string instead of pipe) - common.sh: add WinGet Links to PATH for jq availability on Windows - 05-contributor-growth: fix pull_request_number → pull_request_id - 05-contributor-growth: fix null total_addition/total_deletion (sum from files) - 05-contributor-growth: fix wiki publish 400 error (use timestamp in title) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Donkey_kevin
parent
a7513cf683
commit
a3c433e697
|
|
@ -0,0 +1,295 @@
|
|||
#!/usr/bin/env bash
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
# Scenario 1: Community Operations Automation
|
||||
# Flow: Issue auto-classify → Assign responsible → Weekly report → Release notes
|
||||
#
|
||||
# Commands/Skills chained:
|
||||
# 1. issue +list -- fetch open issues
|
||||
# 2. issue +view -- read issue details
|
||||
# 3. issue +batch-label -- add classification labels
|
||||
# 4. issue +batch-assign -- assign responsible person
|
||||
# 5. pr +list -- collect merged PRs for weekly report
|
||||
# 6. wiki +create -- publish community weekly report
|
||||
# 7. release +create -- publish release notes
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
source "$SCRIPT_DIR/lib/common.sh"
|
||||
|
||||
usage() {
|
||||
echo "Usage: $0 --owner OWNER --repo REPO [--week WEEKS_AGO] [--dry-run]"
|
||||
echo ""
|
||||
echo " --owner OWNER Repository owner (org or user)"
|
||||
echo " --repo REPO Repository name"
|
||||
echo " --week N Generate report for N weeks ago (default: 0 = this week)"
|
||||
echo " --dry-run Preview actions without executing"
|
||||
exit 1
|
||||
}
|
||||
|
||||
WEEKS_AGO=0
|
||||
DRY_RUN=false
|
||||
OWNER=""
|
||||
REPO=""
|
||||
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case "$1" in
|
||||
--owner) OWNER="$2"; shift 2 ;;
|
||||
--repo) REPO="$2"; shift 2 ;;
|
||||
--week) WEEKS_AGO="$2"; shift 2 ;;
|
||||
--dry-run) DRY_RUN="true"; shift ;;
|
||||
--help|-h) usage ;;
|
||||
*) log_err "Unknown arg: $1"; usage ;;
|
||||
esac
|
||||
done
|
||||
|
||||
check_auth
|
||||
require_owner_repo
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
log_title "Phase 1: Issue Auto-Classification"
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
log_step "Fetching open issues..."
|
||||
ISSUES_JSON=$(gl_check issue +list --owner "$OWNER" --repo "$REPO" --state open --limit 100)
|
||||
ISSUE_COUNT=$(echo "$ISSUES_JSON" | jq '.data.issues | length')
|
||||
log_ok "Found $ISSUE_COUNT open issues"
|
||||
|
||||
if [[ "$ISSUE_COUNT" -gt 0 ]]; then
|
||||
# Classify each issue by keywords in title/description
|
||||
declare -A LABEL_MAP=()
|
||||
BUG_IDS=()
|
||||
FEATURE_IDS=()
|
||||
QUESTION_IDS=()
|
||||
DOCS_IDS=()
|
||||
|
||||
log_step "Classifying issues by content..."
|
||||
|
||||
for i in $(seq 0 $((ISSUE_COUNT - 1))); do
|
||||
ISSUE_ID=$(echo "$ISSUES_JSON" | jq -r ".data.issues[$i].id")
|
||||
ISSUE_TITLE=$(echo "$ISSUES_JSON" | jq -r ".data.issues[$i].subject // .data.issues[$i].title // \"\"")
|
||||
ISSUE_DESC=$(echo "$ISSUES_JSON" | jq -r ".data.issues[$i].description // \"\"" | head -c 500)
|
||||
COMBINED="$ISSUE_TITLE $ISSUE_DESC"
|
||||
|
||||
# Keyword-based classification
|
||||
if echo "$COMBINED" | grep -qiE 'bug|error|crash|fault|fix|修复|错误|异常|崩溃'; then
|
||||
BUG_IDS+=("$ISSUE_ID")
|
||||
log_info " #$ISSUE_ID → BUG: $ISSUE_TITLE"
|
||||
elif echo "$COMBINED" | grep -qiE 'feature|新增|建议|enhancement|add|support|功能'; then
|
||||
FEATURE_IDS+=("$ISSUE_ID")
|
||||
log_info " #$ISSUE_ID → FEATURE: $ISSUE_TITLE"
|
||||
elif echo "$COMBINED" | grep -qiE 'how|怎么|如何|question|help|\?|？'; then
|
||||
QUESTION_IDS+=("$ISSUE_ID")
|
||||
log_info " #$ISSUE_ID → QUESTION: $ISSUE_TITLE"
|
||||
elif echo "$COMBINED" | grep -qiE 'doc|文档|readme|说明|guide'; then
|
||||
DOCS_IDS+=("$ISSUE_ID")
|
||||
log_info " #$ISSUE_ID → DOCS: $ISSUE_TITLE"
|
||||
else
|
||||
log_info " #$ISSUE_ID → UNCATEGORIZED: $ISSUE_TITLE"
|
||||
fi
|
||||
done
|
||||
|
||||
divider
|
||||
log_info "Classification summary:"
|
||||
log_info " Bugs: ${#BUG_IDS[@]}"
|
||||
log_info " Features: ${#FEATURE_IDS[@]}"
|
||||
log_info " Questions: ${#QUESTION_IDS[@]}"
|
||||
log_info " Docs: ${#DOCS_IDS[@]}"
|
||||
|
||||
# Apply labels via batch-label
|
||||
if [[ ${#BUG_IDS[@]} -gt 0 ]]; then
|
||||
log_step "Labeling bug issues..."
|
||||
for bid in "${BUG_IDS[@]}"; do
|
||||
gl_run issue +label-add --owner "$OWNER" --repo "$REPO" --number "$bid" --labels "bug" > /dev/null 2>&1 || true
|
||||
done
|
||||
log_ok "Labeled ${#BUG_IDS[@]} bug issues"
|
||||
fi
|
||||
|
||||
if [[ ${#FEATURE_IDS[@]} -gt 0 ]]; then
|
||||
log_step "Labeling feature issues..."
|
||||
for fid in "${FEATURE_IDS[@]}"; do
|
||||
gl_run issue +label-add --owner "$OWNER" --repo "$REPO" --number "$fid" --labels "feature" > /dev/null 2>&1 || true
|
||||
done
|
||||
log_ok "Labeled ${#FEATURE_IDS[@]} feature issues"
|
||||
fi
|
||||
|
||||
if [[ ${#QUESTION_IDS[@]} -gt 0 ]]; then
|
||||
log_step "Labeling question issues..."
|
||||
for qid in "${QUESTION_IDS[@]}"; do
|
||||
gl_run issue +label-add --owner "$OWNER" --repo "$REPO" --number "$qid" --labels "question" > /dev/null 2>&1 || true
|
||||
done
|
||||
log_ok "Labeled ${#QUESTION_IDS[@]} question issues"
|
||||
fi
|
||||
|
||||
if [[ ${#DOCS_IDS[@]} -gt 0 ]]; then
|
||||
log_step "Labeling docs issues..."
|
||||
for did in "${DOCS_IDS[@]}"; do
|
||||
gl_run issue +label-add --owner "$OWNER" --repo "$REPO" --number "$did" --labels "documentation" > /dev/null 2>&1 || true
|
||||
done
|
||||
log_ok "Labeled ${#DOCS_IDS[@]} docs issues"
|
||||
fi
|
||||
fi
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
log_title "Phase 2: Assign Responsible Persons"
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
log_step "Fetching repo members for assignment..."
|
||||
MEMBERS_JSON=$(gl_run repo +members --owner "$OWNER" --repo "$REPO" --limit 50)
|
||||
MEMBER_COUNT=$(echo "$MEMBERS_JSON" | jq '.data.members | length' 2>/dev/null || echo "0")
|
||||
|
||||
if [[ "$MEMBER_COUNT" -gt 0 ]]; then
|
||||
# Assign bugs to first member, features to second, etc. (round-robin)
|
||||
MEMBER_LOGINS=()
|
||||
for i in $(seq 0 $((MEMBER_COUNT - 1))); do
|
||||
LOGIN=$(echo "$MEMBERS_JSON" | jq -r ".data.members[$i].login // .data.members[$i].username // empty")
|
||||
[[ -n "$LOGIN" ]] && MEMBER_LOGINS+=("$LOGIN")
|
||||
done
|
||||
|
||||
if [[ ${#MEMBER_LOGINS[@]} -gt 0 ]]; then
|
||||
assign_issues() {
|
||||
local label="$1"
|
||||
shift
|
||||
local ids=("$@")
|
||||
local member_idx=0
|
||||
for id in "${ids[@]}"; do
|
||||
local assignee="${MEMBER_LOGINS[$((member_idx % ${#MEMBER_LOGINS[@]}))]}"
|
||||
gl_run issue +update --owner "$OWNER" --repo "$REPO" --number "$id" --assignee "$assignee" > /dev/null 2>&1 || true
|
||||
log_info " Assigned #$id → @$assignee"
|
||||
((member_idx++))
|
||||
done
|
||||
}
|
||||
|
||||
log_step "Assigning bug issues..."
|
||||
assign_issues "bug" "${BUG_IDS[@]}" 2>/dev/null || true
|
||||
log_step "Assigning feature issues..."
|
||||
assign_issues "feature" "${FEATURE_IDS[@]}" 2>/dev/null || true
|
||||
log_ok "Assignment complete"
|
||||
fi
|
||||
else
|
||||
log_warn "No repo members found, skipping assignment"
|
||||
fi
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
log_title "Phase 3: Generate Community Weekly Report"
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
WEEK_START=$(date -d "$((WEEKS_AGO * 7)) days ago" +%Y-%m-%d 2>/dev/null || date_today)
|
||||
WEEK_END=$(date_today)
|
||||
|
||||
log_step "Collecting weekly data (week of $WEEK_START)..."
|
||||
|
||||
# Closed issues this week
|
||||
CLOSED_ISSUES=$(gl_run issue +list --owner "$OWNER" --repo "$REPO" --state closed --limit 100)
|
||||
CLOSED_COUNT=$(echo "$CLOSED_ISSUES" | jq '.data.issues | length' 2>/dev/null || echo "0")
|
||||
|
||||
# Merged PRs this week
|
||||
MERGED_PRS=$(gl_run pr +list --owner "$OWNER" --repo "$REPO" --state merged --limit 100)
|
||||
MERGED_COUNT=$(echo "$MERGED_PRS" | jq '.data.issues | length' 2>/dev/null || echo "0")
|
||||
|
||||
# New issues
|
||||
NEW_ISSUES_COUNT=$ISSUE_COUNT
|
||||
|
||||
# Build weekly report
|
||||
REPORT_TITLE="Community Weekly Report: $WEEK_START ~ $WEEK_END"
|
||||
REPORT_BODY="# $REPORT_TITLE
|
||||
|
||||
## Summary
|
||||
- New Issues: **$NEW_ISSUES_COUNT**
|
||||
- Closed Issues: **$CLOSED_COUNT**
|
||||
- Merged PRs: **$MERGED_COUNT**
|
||||
|
||||
## Issue Classification
|
||||
| Type | Count |
|
||||
|------|-------|
|
||||
| Bug | ${#BUG_IDS[@]} |
|
||||
| Feature | ${#FEATURE_IDS[@]} |
|
||||
| Question | ${#QUESTION_IDS[@]} |
|
||||
| Docs | ${#DOCS_IDS[@]} |
|
||||
|
||||
## Highlights
|
||||
- Auto-classified and labeled $(( ${#BUG_IDS[@]} + ${#FEATURE_IDS[@]} + ${#QUESTION_IDS[@]} + ${#DOCS_IDS[@]} )) issues
|
||||
- Assigned responsible persons for bug and feature issues
|
||||
|
||||
---
|
||||
*Auto-generated by gitlink-cli community-ops workflow*"
|
||||
|
||||
log_ok "Weekly report generated"
|
||||
echo ""
|
||||
echo "$REPORT_BODY"
|
||||
|
||||
# Publish to Wiki
|
||||
log_step "Publishing weekly report to Wiki..."
|
||||
WIKI_RESULT=$(gl_run wiki +create --owner "$OWNER" --repo "$REPO" \
|
||||
--title "$REPORT_TITLE" \
|
||||
--content "$REPORT_BODY" 2>&1) || true
|
||||
|
||||
if [[ "$(json_ok "$WIKI_RESULT")" == "true" ]]; then
|
||||
log_ok "Weekly report published to Wiki"
|
||||
else
|
||||
log_warn "Wiki publish may have failed (wiki module might not be enabled)"
|
||||
fi
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
log_title "Phase 4: Auto-Publish Release Notes"
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
log_step "Collecting recent changes for release notes..."
|
||||
|
||||
# Get recent commits via compare API
|
||||
TAG_NAME="weekly-$(date +%Y%m%d)"
|
||||
RELEASE_NAME="Weekly Release $(date +%Y-%m-%d)"
|
||||
|
||||
# Build release notes from closed issues and merged PRs
|
||||
RELEASE_BODY="# Release Notes - $(date +%Y-%m-%d)
|
||||
|
||||
## Merged PRs ($MERGED_COUNT)"
|
||||
|
||||
if [[ "$MERGED_COUNT" -gt 0 ]]; then
|
||||
for i in $(seq 0 $((MERGED_COUNT > 10 ? 9 : MERGED_COUNT - 1))); do
|
||||
PR_TITLE=$(echo "$MERGED_PRS" | jq -r ".data.issues[$i].subject // .data.issues[$i].title // \"\"")
|
||||
PR_NUM=$(echo "$MERGED_PRS" | jq -r ".data.issues[$i].id // .data.issues[$i].number // \"\"")
|
||||
RELEASE_BODY+=$'\n'"- #$PR_NUM $PR_TITLE"
|
||||
done
|
||||
fi
|
||||
|
||||
RELEASE_BODY+="
|
||||
|
||||
## Closed Issues ($CLOSED_COUNT)"
|
||||
|
||||
if [[ "$CLOSED_COUNT" -gt 0 ]]; then
|
||||
for i in $(seq 0 $((CLOSED_COUNT > 10 ? 9 : CLOSED_COUNT - 1))); do
|
||||
ISSUE_TITLE=$(echo "$CLOSED_ISSUES" | jq -r ".data.issues[$i].subject // .data.issues[$i].title // \"\"")
|
||||
ISSUE_NUM=$(echo "$CLOSED_ISSUES" | jq -r ".data.issues[$i].id // .data.issues[$i].number // \"\"")
|
||||
RELEASE_BODY+=$'\n'"- #$ISSUE_NUM $ISSUE_TITLE"
|
||||
done
|
||||
fi
|
||||
|
||||
RELEASE_BODY+="
|
||||
|
||||
---
|
||||
*Auto-generated by gitlink-cli community-ops workflow*"
|
||||
|
||||
log_step "Creating release: $TAG_NAME..."
|
||||
RELEASE_RESULT=$(gl_run release +create --owner "$OWNER" --repo "$REPO" \
|
||||
--tag "$TAG_NAME" \
|
||||
--name "$RELEASE_NAME" \
|
||||
--body "$RELEASE_BODY" 2>&1) || true
|
||||
|
||||
if [[ "$(json_ok "$RELEASE_RESULT")" == "true" ]]; then
|
||||
log_ok "Release $TAG_NAME created successfully"
|
||||
else
|
||||
log_warn "Release creation may have failed (tag might already exist)"
|
||||
log_info "You can manually create with: gitlink-cli release +create --owner $OWNER --repo $REPO --tag $TAG_NAME --name '$RELEASE_NAME'"
|
||||
fi
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
log_title "Community Operations Complete"
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
echo -e "${GREEN}Summary:${NC}"
|
||||
echo " Issues classified: $(( ${#BUG_IDS[@]} + ${#FEATURE_IDS[@]} + ${#QUESTION_IDS[@]} + ${#DOCS_IDS[@]} ))"
|
||||
echo " Closed this week: $CLOSED_COUNT"
|
||||
echo " Merged PRs: $MERGED_COUNT"
|
||||
echo " Weekly report: Published to Wiki"
|
||||
echo " Release notes: $TAG_NAME"
|
||||
echo ""
|
||||
|
|
@ -0,0 +1,484 @@
|
|||
#!/usr/bin/env bash
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
# Scenario 2: Code Quality Gatekeeper
|
||||
# Flow: PR submit → Load Skill → Auto Review → Check CI → Auto-merge
|
||||
#
|
||||
# Commands/Skills chained:
|
||||
# 1. pr +list -- list open PRs
|
||||
# 2. pr +view -- get PR details
|
||||
# 3. pr +files -- get changed files
|
||||
# 4. pr +diff -- get diff content
|
||||
# 5. gitlink-code-review -- AI code review (skill-driven)
|
||||
# 6. api POST .../reviews -- post review comment with scores
|
||||
# 7. ci +builds -- check CI build status
|
||||
# 8. pr +merge -- auto-merge if quality passes threshold
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
source "$SCRIPT_DIR/lib/common.sh"
|
||||
|
||||
usage() {
|
||||
echo "Usage: $0 --owner OWNER --repo REPO [--pr-id ID] [--threshold SCORE] [--dry-run]"
|
||||
echo ""
|
||||
echo " --owner OWNER Repository owner"
|
||||
echo " --repo REPO Repository name"
|
||||
echo " --pr-id ID Specific PR to review (default: all open PRs)"
|
||||
echo " --threshold SCORE Min quality score to auto-merge (default: 80)"
|
||||
echo " --dry-run Preview actions without executing"
|
||||
exit 1
|
||||
}
|
||||
|
||||
THRESHOLD=80
|
||||
DRY_RUN=false
|
||||
OWNER=""
|
||||
REPO=""
|
||||
PR_ID=""
|
||||
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case "$1" in
|
||||
--owner) OWNER="$2"; shift 2 ;;
|
||||
--repo) REPO="$2"; shift 2 ;;
|
||||
--pr-id) PR_ID="$2"; shift 2 ;;
|
||||
--threshold) THRESHOLD="$2"; shift 2 ;;
|
||||
--dry-run) DRY_RUN="true"; shift ;;
|
||||
--help|-h) usage ;;
|
||||
*) log_err "Unknown arg: $1"; usage ;;
|
||||
esac
|
||||
done
|
||||
|
||||
check_auth
|
||||
require_owner_repo
|
||||
|
||||
# ── Review a single PR ───────────────────────────────────────────────
|
||||
review_pr() {
|
||||
local pr_id="$1"
|
||||
|
||||
log_title "Reviewing PR #$pr_id"
|
||||
|
||||
# Initialize arrays
|
||||
ISSUES_FOUND=()
|
||||
AI_POSITIVE=()
|
||||
AI_RECOMMENDATIONS=()
|
||||
|
||||
# Step 1: Get PR details
|
||||
log_step "Fetching PR details..."
|
||||
PR_JSON=$(gl_check pr +view --owner "$OWNER" --repo "$REPO" --id "$pr_id")
|
||||
PR_TITLE=$(echo "$PR_JSON" | jq -r '.data.title // .data.subject // "N/A"')
|
||||
PR_STATE=$(echo "$PR_JSON" | jq -r '.data.state // .data.status // "N/A"')
|
||||
PR_AUTHOR=$(echo "$PR_JSON" | jq -r '.data.author.login // .data.author.username // .data.user.login // "N/A"')
|
||||
log_ok "PR #$pr_id: \"$PR_TITLE\" by @$PR_AUTHOR (state: $PR_STATE)"
|
||||
|
||||
# Step 2: Get changed files
|
||||
log_step "Fetching changed files..."
|
||||
FILES_JSON=$(gl_run pr +files --owner "$OWNER" --repo "$REPO" --id "$pr_id")
|
||||
FILE_COUNT=0
|
||||
if echo "$FILES_JSON" | jq empty 2>/dev/null; then
|
||||
FILE_COUNT=$(echo "$FILES_JSON" | jq '.data.files | length' 2>/dev/null || echo "0")
|
||||
fi
|
||||
log_ok "Changed files: $FILE_COUNT"
|
||||
|
||||
# List changed files
|
||||
if [[ "$FILE_COUNT" -gt 0 ]] && [[ "$FILE_COUNT" != "null" ]]; then
|
||||
for i in $(seq 0 $((FILE_COUNT - 1))); do
|
||||
FNAME=$(echo "$FILES_JSON" | jq -r ".data.files[$i].name // .data.files[$i].filename // \"unknown\"" 2>/dev/null || echo "unknown")
|
||||
echo " $FNAME"
|
||||
done
|
||||
fi
|
||||
|
||||
# Step 3: Get diff (extract file names and content from diff response)
|
||||
log_step "Fetching diff..."
|
||||
DIFF_JSON=$(gl_run pr +diff --owner "$OWNER" --repo "$REPO" --id "$pr_id")
|
||||
DIFF_CONTENT=""
|
||||
if echo "$DIFF_JSON" | jq empty 2>/dev/null; then
|
||||
DIFF_CONTENT=$(echo "$DIFF_JSON" | jq -r '
|
||||
[.data.files[]?.sections[]?.lines[]?.content // empty] | join("\n")
|
||||
' 2>/dev/null | head -c 5000 || true)
|
||||
fi
|
||||
DIFF_LINES=$(echo "$DIFF_CONTENT" | wc -l)
|
||||
log_ok "Diff: $DIFF_LINES lines"
|
||||
|
||||
# Step 4: AI-powered code review
|
||||
log_step "AI analyzing code quality..."
|
||||
|
||||
# Build file list string
|
||||
FILE_LIST=""
|
||||
if [[ "$FILE_COUNT" -gt 0 ]] && [[ "$FILE_COUNT" != "null" ]]; then
|
||||
for i in $(seq 0 $((FILE_COUNT - 1))); do
|
||||
FNAME=$(echo "$FILES_JSON" | jq -r ".data.files[$i].name // .data.files[$i].filename // \"unknown\"" 2>/dev/null || echo "unknown")
|
||||
FILE_LIST+="- $FNAME"$'\n'
|
||||
done
|
||||
fi
|
||||
|
||||
# Truncate diff to fit within context limits
|
||||
DIFF_TRUNCATED=$(echo "$DIFF_CONTENT" | head -c 4000)
|
||||
|
||||
# ── Load gitlink-code-review skill (concise version) ──────────
|
||||
SKILL_DIR="$SCRIPT_DIR/../skills/gitlink-code-review"
|
||||
SKILL_DIMENSIONS=""
|
||||
if [[ -f "$SKILL_DIR/SKILL.md" ]]; then
|
||||
SKILL_DIMENSIONS=$(sed -n '/^## 📊 审查维度/,/^## 🔧 使用方式/p' "$SKILL_DIR/SKILL.md" | grep '^\- \*\*' | head -20)
|
||||
fi
|
||||
|
||||
REVIEW_PROMPT="你是代码审查专家。请按 gitlink-code-review skill 的审查维度分析以下 PR。
|
||||
|
||||
## 审查维度与检查项
|
||||
|
||||
${SKILL_DIMENSIONS:-1. 代码质量: 复杂度、命名、注释、格式
|
||||
2. 安全性: SQL注入、XSS、敏感信息、认证、输入验证
|
||||
3. 性能: 循环效率、资源泄漏、N+1查询、内存
|
||||
4. 可维护性: 代码重复、职责单一、依赖耦合、测试覆盖}
|
||||
|
||||
## 评分标准
|
||||
- 90-100: 优秀，可直接合并
|
||||
- 75-89: 良好，建议合并
|
||||
- 60-74: 一般，需要改进
|
||||
- <60: 较差，不建议合并
|
||||
|
||||
## 问题严重级别
|
||||
- CRITICAL: 阻止合并
|
||||
- HIGH: 强烈建议修复
|
||||
- MEDIUM: 建议修复
|
||||
- LOW: 可选修复
|
||||
|
||||
## PR 数据
|
||||
|
||||
PR 标题: $PR_TITLE
|
||||
变更文件:
|
||||
$FILE_LIST
|
||||
代码差异:
|
||||
$DIFF_TRUNCATED
|
||||
|
||||
## 输出要求
|
||||
|
||||
请严格按以下 JSON 格式输出，不要输出其他内容:
|
||||
{\"total\": <0-100>, \"quality\": <0-25>, \"security\": <0-25>, \"performance\": <0-25>, \"maintainability\": <0-25>, \"issues\": [{\"severity\": \"HIGH/MEDIUM/LOW\", \"category\": \"quality/security/performance/maintainability\", \"file\": \"文件路径\", \"rule\": \"规则名\", \"description\": \"问题描述\", \"suggestion\": \"修复建议\"}], \"positive_notes\": [{\"description\": \"优秀实践描述\"}], \"recommendations\": [\"改进建议1\"], \"verdict\": \"PASS或FAIL\"}"
|
||||
|
||||
# Call Claude Code CLI for AI review
|
||||
AI_AVAILABLE=false
|
||||
if command -v claude &>/dev/null; then
|
||||
log_info "Calling AI agent for code review (may take 30-60s)..."
|
||||
PROMPT_FILE=$(mktemp)
|
||||
AI_OUT_FILE=$(mktemp)
|
||||
echo "$REVIEW_PROMPT" > "$PROMPT_FILE"
|
||||
|
||||
# Run claude in a subshell to isolate from set -euo pipefail
|
||||
AI_EXIT=0
|
||||
(
|
||||
timeout 120 claude -p --output-format json < "$PROMPT_FILE" > "$AI_OUT_FILE" 2>/dev/null
|
||||
) || AI_EXIT=$?
|
||||
|
||||
if [[ $AI_EXIT -eq 0 ]] && [[ -s "$AI_OUT_FILE" ]]; then
|
||||
# Parse Claude CLI JSON response
|
||||
AI_RESULT=$(jq -r '.result // empty' "$AI_OUT_FILE" 2>/dev/null)
|
||||
else
|
||||
log_warn "AI call failed (exit: $AI_EXIT), falling back to keyword-based"
|
||||
AI_RESULT=""
|
||||
fi
|
||||
rm -f "$PROMPT_FILE" "$AI_OUT_FILE"
|
||||
|
||||
if [[ -n "$AI_RESULT" ]]; then
|
||||
# Extract JSON block from AI response (may contain markdown wrapping)
|
||||
# Use python for reliable JSON extraction from mixed content
|
||||
AI_JSON=""
|
||||
if command -v python3 &>/dev/null; then
|
||||
AI_JSON=$(python3 -c "
|
||||
import sys, json
|
||||
text = sys.stdin.read()
|
||||
# Find JSON by balanced brace matching
|
||||
depth = 0
|
||||
start = -1
|
||||
results = []
|
||||
for i, c in enumerate(text):
|
||||
if c == '{':
|
||||
if depth == 0:
|
||||
start = i
|
||||
depth += 1
|
||||
elif c == '}':
|
||||
depth -= 1
|
||||
if depth == 0 and start >= 0:
|
||||
results.append(text[start:i+1])
|
||||
start = -1
|
||||
for m in reversed(results):
|
||||
try:
|
||||
obj = json.loads(m)
|
||||
if 'total' in obj and 'verdict' in obj:
|
||||
print(json.dumps(obj))
|
||||
break
|
||||
except: pass
|
||||
" <<< "$AI_RESULT" 2>/dev/null)
|
||||
fi
|
||||
# Fallback: simple grep extraction
|
||||
if [[ -z "$AI_JSON" ]]; then
|
||||
AI_JSON=$(echo "$AI_RESULT" | grep -oP '\{[^{}]*(?:\{[^{}]*\}[^{}]*)*\}' | tail -1)
|
||||
fi
|
||||
|
||||
if [[ -n "$AI_JSON" ]] && echo "$AI_JSON" | jq empty 2>/dev/null; then
|
||||
TOTAL_SCORE=$(echo "$AI_JSON" | jq -r '.total // 0' 2>/dev/null)
|
||||
SCORE_QUALITY=$(echo "$AI_JSON" | jq -r '.quality // 0' 2>/dev/null)
|
||||
SCORE_SECURITY=$(echo "$AI_JSON" | jq -r '.security // 0' 2>/dev/null)
|
||||
SCORE_PERFORMANCE=$(echo "$AI_JSON" | jq -r '.performance // 0' 2>/dev/null)
|
||||
SCORE_MAINTAINABILITY=$(echo "$AI_JSON" | jq -r '.maintainability // 0' 2>/dev/null)
|
||||
AI_VERDICT=$(echo "$AI_JSON" | jq -r '.verdict // "PASS"' 2>/dev/null)
|
||||
|
||||
# Extract structured issues array (objects with severity/category/description)
|
||||
ISSUES_FOUND=()
|
||||
ISSUE_COUNT=$(echo "$AI_JSON" | jq '.issues | length' 2>/dev/null || echo "0")
|
||||
if [[ "$ISSUE_COUNT" -gt 0 ]] && [[ "$ISSUE_COUNT" != "null" ]]; then
|
||||
for idx in $(seq 0 $((ISSUE_COUNT - 1))); do
|
||||
# Support both structured objects and plain strings
|
||||
issue=$(echo "$AI_JSON" | jq -r '
|
||||
if .issues['"$idx"'] | type == "object" then
|
||||
"[" + (.issues['"$idx"'].severity // "?") + "] " +
|
||||
(.issues['"$idx"'].category // "?") + ": " +
|
||||
(.issues['"$idx"'].description // .issues['"$idx"'].rule // "unknown") +
|
||||
(if .issues['"$idx"'].file then " (" + .issues['"$idx"'].file + ")" else "" end) +
|
||||
(if .issues['"$idx"'].suggestion then " → " + .issues['"$idx"'].suggestion else "" end)
|
||||
else
|
||||
.issues['"$idx"'] // empty
|
||||
end
|
||||
' 2>/dev/null)
|
||||
[[ -n "$issue" ]] && ISSUES_FOUND+=("$issue")
|
||||
done
|
||||
fi
|
||||
|
||||
# Extract positive notes and recommendations
|
||||
AI_POSITIVE=()
|
||||
POS_COUNT=$(echo "$AI_JSON" | jq '.positive_notes | length' 2>/dev/null || echo "0")
|
||||
if [[ "$POS_COUNT" -gt 0 ]] && [[ "$POS_COUNT" != "null" ]]; then
|
||||
for idx in $(seq 0 $((POS_COUNT - 1))); do
|
||||
note=$(echo "$AI_JSON" | jq -r '.positive_notes['"$idx"'].description // empty' 2>/dev/null)
|
||||
[[ -n "$note" ]] && AI_POSITIVE+=("$note")
|
||||
done
|
||||
fi
|
||||
|
||||
AI_RECOMMENDATIONS=()
|
||||
REC_COUNT=$(echo "$AI_JSON" | jq '.recommendations | length' 2>/dev/null || echo "0")
|
||||
if [[ "$REC_COUNT" -gt 0 ]] && [[ "$REC_COUNT" != "null" ]]; then
|
||||
for idx in $(seq 0 $((REC_COUNT - 1))); do
|
||||
rec=$(echo "$AI_JSON" | jq -r '.recommendations['"$idx"'] // empty' 2>/dev/null)
|
||||
[[ -n "$rec" ]] && AI_RECOMMENDATIONS+=("$rec")
|
||||
done
|
||||
fi
|
||||
|
||||
AI_AVAILABLE=true
|
||||
log_ok "AI review complete (verdict: $AI_VERDICT)"
|
||||
else
|
||||
log_warn "Could not parse AI response JSON, falling back to keyword-based"
|
||||
fi
|
||||
fi
|
||||
fi
|
||||
|
||||
# Fallback: keyword-based heuristics if AI is not available
|
||||
if [[ "$AI_AVAILABLE" != "true" ]]; then
|
||||
log_warn "AI not available, falling back to keyword-based analysis"
|
||||
|
||||
SCORE_QUALITY=25
|
||||
SCORE_SECURITY=25
|
||||
SCORE_PERFORMANCE=25
|
||||
SCORE_MAINTAINABILITY=25
|
||||
ISSUES_FOUND=()
|
||||
|
||||
if echo "$DIFF_CONTENT" | grep -qiE 'password|secret|token|api_key|apikey|private_key'; then
|
||||
SCORE_SECURITY=$((SCORE_SECURITY - 15))
|
||||
ISSUES_FOUND+=("SECURITY: 检测到可能的硬编码凭证")
|
||||
fi
|
||||
if echo "$DIFF_CONTENT" | grep -qiE 'eval\(|exec\(|system\(|shell_exec|os\.system|subprocess\.call'; then
|
||||
SCORE_SECURITY=$((SCORE_SECURITY - 10))
|
||||
ISSUES_FOUND+=("SECURITY: 检测到危险函数调用")
|
||||
fi
|
||||
if echo "$DIFF_CONTENT" | grep -qiE 'TODO|FIXME|HACK|XXX'; then
|
||||
SCORE_QUALITY=$((SCORE_QUALITY - 5))
|
||||
ISSUES_FOUND+=("QUALITY: 存在 TODO/FIXME/HACK 注释")
|
||||
fi
|
||||
if echo "$DIFF_CONTENT" | grep -qiE 'SELECT \*|\.findAll\(\)|\.all\(\)'; then
|
||||
SCORE_PERFORMANCE=$((SCORE_PERFORMANCE - 10))
|
||||
ISSUES_FOUND+=("PERFORMANCE: 可能的全表查询")
|
||||
fi
|
||||
if echo "$DIFF_CONTENT" | grep -qiE 'sleep\(|time\.sleep|Thread\.sleep'; then
|
||||
SCORE_PERFORMANCE=$((SCORE_PERFORMANCE - 5))
|
||||
ISSUES_FOUND+=("PERFORMANCE: 检测到阻塞式 sleep")
|
||||
fi
|
||||
if [[ "$FILE_COUNT" -gt 20 ]]; then
|
||||
SCORE_MAINTAINABILITY=$((SCORE_MAINTAINABILITY - 10))
|
||||
ISSUES_FOUND+=("MAINTAINABILITY: 变更文件数量过多 ($FILE_COUNT)")
|
||||
fi
|
||||
|
||||
TOTAL_SCORE=$((SCORE_QUALITY + SCORE_SECURITY + SCORE_PERFORMANCE + SCORE_MAINTAINABILITY))
|
||||
TOTAL_SCORE=$((TOTAL_SCORE < 0 ? 0 : TOTAL_SCORE))
|
||||
fi
|
||||
|
||||
# Print review report
|
||||
divider
|
||||
if [[ "$AI_AVAILABLE" == "true" ]]; then
|
||||
log_info "AI Review Report for PR #$pr_id"
|
||||
else
|
||||
log_info "Review Report for PR #$pr_id (keyword-based)"
|
||||
fi
|
||||
echo ""
|
||||
echo " Overall Score: $TOTAL_SCORE / 100"
|
||||
echo " Code Quality: $SCORE_QUALITY / 25"
|
||||
echo " Security: $SCORE_SECURITY / 25"
|
||||
echo " Performance: $SCORE_PERFORMANCE / 25"
|
||||
echo " Maintainability: $SCORE_MAINTAINABILITY / 25"
|
||||
echo ""
|
||||
|
||||
if [[ ${#ISSUES_FOUND[@]} -gt 0 ]]; then
|
||||
echo " Issues Found:"
|
||||
for issue in "${ISSUES_FOUND[@]}"; do
|
||||
echo " - $issue"
|
||||
done
|
||||
echo ""
|
||||
fi
|
||||
|
||||
if [[ "${#AI_POSITIVE[@]}" -gt 0 ]]; then
|
||||
echo " Positive Notes:"
|
||||
for note in "${AI_POSITIVE[@]}"; do
|
||||
echo " + $note"
|
||||
done
|
||||
echo ""
|
||||
fi
|
||||
|
||||
if [[ "${#AI_RECOMMENDATIONS[@]}" -gt 0 ]]; then
|
||||
echo " Recommendations:"
|
||||
for rec in "${AI_RECOMMENDATIONS[@]}"; do
|
||||
echo " > $rec"
|
||||
done
|
||||
echo ""
|
||||
fi
|
||||
|
||||
# Step 5: Post review comment
|
||||
if [[ "$AI_AVAILABLE" == "true" ]]; then
|
||||
REVIEW_HEADER="## AI Code Quality Review - PR #$pr_id"
|
||||
else
|
||||
REVIEW_HEADER="## Code Quality Review - PR #$pr_id (keyword-based)"
|
||||
fi
|
||||
|
||||
REVIEW_BODY="$REVIEW_HEADER
|
||||
|
||||
### Scores
|
||||
| Dimension | Score | Max |
|
||||
|-----------|-------|-----|
|
||||
| Code Quality | $SCORE_QUALITY | 25 |
|
||||
| Security | $SCORE_SECURITY | 25 |
|
||||
| Performance | $SCORE_PERFORMANCE | 25 |
|
||||
| Maintainability | $SCORE_MAINTAINABILITY | 25 |
|
||||
| **Total** | **$TOTAL_SCORE** | **100** |
|
||||
|
||||
### Issues Found"
|
||||
|
||||
if [[ ${#ISSUES_FOUND[@]} -gt 0 ]]; then
|
||||
for issue in "${ISSUES_FOUND[@]}"; do
|
||||
REVIEW_BODY+=$'\n'"- $issue"
|
||||
done
|
||||
else
|
||||
REVIEW_BODY+=$'\n'"No issues found."
|
||||
fi
|
||||
|
||||
if [[ "${#AI_POSITIVE[@]}" -gt 0 ]]; then
|
||||
REVIEW_BODY+=$'\n'$'\n'"### Positive Notes"
|
||||
for note in "${AI_POSITIVE[@]}"; do
|
||||
REVIEW_BODY+=$'\n'"- $note"
|
||||
done
|
||||
fi
|
||||
|
||||
if [[ "${#AI_RECOMMENDATIONS[@]}" -gt 0 ]]; then
|
||||
REVIEW_BODY+=$'\n'$'\n'"### Recommendations"
|
||||
for rec in "${AI_RECOMMENDATIONS[@]}"; do
|
||||
REVIEW_BODY+=$'\n'"- $rec"
|
||||
done
|
||||
fi
|
||||
|
||||
REVIEW_BODY+="
|
||||
|
||||
### Verdict
|
||||
$(if [[ $TOTAL_SCORE -ge $THRESHOLD ]]; then echo "**PASS** - Score $TOTAL_SCORE >= threshold $THRESHOLD. Ready to merge."; else echo "**FAIL** - Score $TOTAL_SCORE < threshold $THRESHOLD. Please address the issues above."; fi)
|
||||
|
||||
---
|
||||
*Auto-reviewed by gitlink-cli code-quality-gatekeeper workflow (skill: gitlink-code-review)*"
|
||||
|
||||
log_step "Posting review comment..."
|
||||
REVIEW_RESULT=$(gl_run api POST "/$OWNER/$REPO/pulls/$pr_id/reviews" \
|
||||
--body "{\"body\": $(echo "$REVIEW_BODY" | jq -Rs .), \"event\": \"$(if [[ $TOTAL_SCORE -ge $THRESHOLD ]]; then echo "APPROVE"; else echo "COMMENT"; fi)\"}" 2>&1) || true
|
||||
|
||||
if [[ "$(json_ok "$REVIEW_RESULT")" == "true" ]]; then
|
||||
log_ok "Review posted"
|
||||
else
|
||||
log_warn "Review post may have failed (review API might not be available)"
|
||||
fi
|
||||
|
||||
# Step 6: Check CI status (API may not be available)
|
||||
log_step "Checking CI build status..."
|
||||
CI_JSON=$(gl_run ci +builds --owner "$OWNER" --repo "$REPO")
|
||||
CI_COUNT=$(echo "$CI_JSON" | jq '.data.builds // .data | length' 2>/dev/null || echo "0")
|
||||
CI_PASSED=true
|
||||
|
||||
if [[ "$CI_COUNT" -gt 0 ]] && [[ "$CI_COUNT" != "null" ]]; then
|
||||
for i in $(seq 0 $((CI_COUNT - 1))); do
|
||||
CI_STATUS=$(echo "$CI_JSON" | jq -r ".data.builds[$i].status // .data.builds[$i].state // .data[$i].status // .data[$i].state // \"unknown\"")
|
||||
CI_NAME=$(echo "$CI_JSON" | jq -r ".data.builds[$i].name // .data[$i].name // \"build\"")
|
||||
if [[ "$CI_STATUS" != "success" && "$CI_STATUS" != "passed" && "$CI_STATUS" != "completed" ]]; then
|
||||
CI_PASSED=false
|
||||
log_warn "CI '$CI_NAME' status: $CI_STATUS"
|
||||
else
|
||||
log_ok "CI '$CI_NAME' status: $CI_STATUS"
|
||||
fi
|
||||
done
|
||||
else
|
||||
log_info "No CI builds found"
|
||||
fi
|
||||
|
||||
# Step 7: Auto-merge if quality passes
|
||||
if [[ $TOTAL_SCORE -ge $THRESHOLD && "$CI_PASSED" == "true" ]]; then
|
||||
log_step "Quality score $TOTAL_SCORE >= $THRESHOLD and CI passed"
|
||||
if [[ "$DRY_RUN" == "true" ]]; then
|
||||
log_warn "[DRY RUN] Would auto-merge PR #$pr_id"
|
||||
else
|
||||
log_step "Auto-merging PR #$pr_id..."
|
||||
MERGE_RESULT=$(gl_run pr +merge --owner "$OWNER" --repo "$REPO" --id "$pr_id" --method merge 2>&1) || true
|
||||
if [[ "$(json_ok "$MERGE_RESULT")" == "true" ]]; then
|
||||
log_ok "PR #$pr_id merged successfully!"
|
||||
else
|
||||
log_err "Auto-merge failed: $(json_error "$MERGE_RESULT")"
|
||||
fi
|
||||
fi
|
||||
else
|
||||
log_warn "PR #$pr_id not auto-merged (score: $TOTAL_SCORE, threshold: $THRESHOLD, CI passed: $CI_PASSED)"
|
||||
fi
|
||||
|
||||
echo ""
|
||||
return 0
|
||||
}
|
||||
|
||||
# ── Main ─────────────────────────────────────────────────────────────
|
||||
log_title "Code Quality Gatekeeper"
|
||||
|
||||
if [[ -n "$PR_ID" ]]; then
|
||||
# Review specific PR
|
||||
review_pr "$PR_ID"
|
||||
else
|
||||
# Review all open PRs
|
||||
log_step "Fetching open PRs..."
|
||||
PRS_JSON=$(gl_check pr +list --owner "$OWNER" --repo "$REPO" --state open --limit 50)
|
||||
PR_COUNT=$(echo "$PRS_JSON" | jq '.data.issues | length')
|
||||
log_ok "Found $PR_COUNT open PRs"
|
||||
|
||||
if [[ "$PR_COUNT" -eq 0 ]]; then
|
||||
log_info "No open PRs to review"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
REVIEWED=0
|
||||
PASSED=0
|
||||
FAILED=0
|
||||
|
||||
for i in $(seq 0 $((PR_COUNT - 1))); do
|
||||
pid=$(echo "$PRS_JSON" | jq -r ".data.issues[$i].pull_request_number // .data.issues[$i].id // empty")
|
||||
[[ -z "$pid" ]] && continue
|
||||
review_pr "$pid"
|
||||
((REVIEWED++))
|
||||
done
|
||||
|
||||
log_title "Gatekeeper Summary"
|
||||
echo " PRs Reviewed: $REVIEWED"
|
||||
echo " Threshold: $THRESHOLD"
|
||||
fi
|
||||
|
|
@ -0,0 +1,347 @@
|
|||
#!/usr/bin/env bash
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
# Scenario 3: One-Click Project Initialization
|
||||
# Flow: Input description → Create repo → README/LICENSE/CI → Issues → Release
|
||||
#
|
||||
# Commands/Skills chained:
|
||||
# 1. repo +create -- create repository
|
||||
# 2. wiki +create -- create README wiki page
|
||||
# 3. wiki +create -- create CONTRIBUTING guide
|
||||
# 4. issue +create -- create initial issues
|
||||
# 5. branch +protect -- protect default branch
|
||||
# 6. release +create -- create initial release
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
source "$SCRIPT_DIR/lib/common.sh"
|
||||
|
||||
usage() {
|
||||
echo "Usage: $0 --owner OWNER --name REPO_NAME --description DESC [--lang LANG] [--private] [--dry-run]"
|
||||
echo ""
|
||||
echo " --owner OWNER Repository owner (org or user)"
|
||||
echo " --name REPO_NAME Repository name"
|
||||
echo " --description DESC Repository description"
|
||||
echo " --lang LANG Primary language: go|python|node|java (default: go)"
|
||||
echo " --private Make repository private"
|
||||
echo " --dry-run Preview actions without executing"
|
||||
exit 1
|
||||
}
|
||||
|
||||
LANG="go"
|
||||
DRY_RUN=false
|
||||
OWNER=""
|
||||
REPO_NAME=""
|
||||
DESCRIPTION=""
|
||||
PRIVATE="false"
|
||||
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case "$1" in
|
||||
--owner) OWNER="$2"; shift 2 ;;
|
||||
--name) REPO_NAME="$2"; shift 2 ;;
|
||||
--description) DESCRIPTION="$2"; shift 2 ;;
|
||||
--lang) LANG="$2"; shift 2 ;;
|
||||
--private) PRIVATE="true"; shift ;;
|
||||
--dry-run) DRY_RUN="true"; shift ;;
|
||||
--help|-h) usage ;;
|
||||
*) log_err "Unknown arg: $1"; usage ;;
|
||||
esac
|
||||
done
|
||||
|
||||
if [[ -z "$OWNER" || -z "$REPO_NAME" || -z "$DESCRIPTION" ]]; then
|
||||
log_err "Missing required parameters: --owner, --name, --description"
|
||||
usage
|
||||
fi
|
||||
|
||||
check_auth
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
log_title "Project Initialization: $OWNER/$REPO_NAME"
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
echo " Owner: $OWNER"
|
||||
echo " Name: $REPO_NAME"
|
||||
echo " Description: $DESCRIPTION"
|
||||
echo " Language: $LANG"
|
||||
echo " Private: $PRIVATE"
|
||||
divider
|
||||
|
||||
# ── Step 1: Create Repository ────────────────────────────────────────
|
||||
log_step "Creating repository..."
|
||||
REPO_RESULT=$(gl_check repo +create --owner "$OWNER" --name "$REPO_NAME" --description "$DESCRIPTION" --private "$PRIVATE")
|
||||
REPO_ID=$(echo "$REPO_RESULT" | jq -r '.data.id // .data.project_id // empty')
|
||||
log_ok "Repository created: $OWNER/$REPO_NAME (id: $REPO_ID)"
|
||||
|
||||
# ── Step 2: Create README ────────────────────────────────────────────
|
||||
log_step "Creating README wiki page..."
|
||||
|
||||
# Wait for repo to be fully initialized
|
||||
sleep 2
|
||||
|
||||
README_CONTENT="# $REPO_NAME
|
||||
|
||||
$DESCRIPTION
|
||||
|
||||
## Getting Started
|
||||
|
||||
### Prerequisites"
|
||||
|
||||
case "$LANG" in
|
||||
go)
|
||||
README_CONTENT+="
|
||||
|
||||
- Go 1.21+
|
||||
- Git
|
||||
|
||||
### Installation
|
||||
|
||||
\`\`\`bash
|
||||
git clone https://gitlink.org.cn/$OWNER/$REPO_NAME.git
|
||||
cd $REPO_NAME
|
||||
go mod download
|
||||
go build ./...
|
||||
\`\`\`
|
||||
|
||||
### Usage
|
||||
|
||||
\`\`\`bash
|
||||
go run main.go
|
||||
\`\`\`
|
||||
|
||||
### Testing
|
||||
|
||||
\`\`\`bash
|
||||
go test ./...
|
||||
\`\`\`"
|
||||
;;
|
||||
python)
|
||||
README_CONTENT+="
|
||||
|
||||
- Python 3.9+
|
||||
- pip
|
||||
|
||||
### Installation
|
||||
|
||||
\`\`\`bash
|
||||
git clone https://gitlink.org.cn/$OWNER/$REPO_NAME.git
|
||||
cd $REPO_NAME
|
||||
pip install -r requirements.txt
|
||||
\`\`\`
|
||||
|
||||
### Usage
|
||||
|
||||
\`\`\`bash
|
||||
python main.py
|
||||
\`\`\`
|
||||
|
||||
### Testing
|
||||
|
||||
\`\`\`bash
|
||||
pytest
|
||||
\`\`\`"
|
||||
;;
|
||||
node)
|
||||
README_CONTENT+="
|
||||
|
||||
- Node.js 18+
|
||||
- npm or yarn
|
||||
|
||||
### Installation
|
||||
|
||||
\`\`\`bash
|
||||
git clone https://gitlink.org.cn/$OWNER/$REPO_NAME.git
|
||||
cd $REPO_NAME
|
||||
npm install
|
||||
\`\`\`
|
||||
|
||||
### Usage
|
||||
|
||||
\`\`\`bash
|
||||
npm start
|
||||
\`\`\`
|
||||
|
||||
### Testing
|
||||
|
||||
\`\`\`bash
|
||||
npm test
|
||||
\`\`\`"
|
||||
;;
|
||||
java)
|
||||
README_CONTENT+="
|
||||
|
||||
- JDK 17+
|
||||
- Maven 3.8+
|
||||
|
||||
### Installation
|
||||
|
||||
\`\`\`bash
|
||||
git clone https://gitlink.org.cn/$OWNER/$REPO_NAME.git
|
||||
cd $REPO_NAME
|
||||
mvn clean install
|
||||
\`\`\`
|
||||
|
||||
### Usage
|
||||
|
||||
\`\`\`bash
|
||||
mvn exec:java
|
||||
\`\`\`
|
||||
|
||||
### Testing
|
||||
|
||||
\`\`\`bash
|
||||
mvn test
|
||||
\`\`\`"
|
||||
;;
|
||||
esac
|
||||
|
||||
README_CONTENT+="
|
||||
|
||||
## Contributing
|
||||
|
||||
See [CONTRIBUTING](./CONTRIBUTING) for guidelines.
|
||||
|
||||
## License
|
||||
|
||||
This project is licensed under the MIT License."
|
||||
|
||||
# Retry wiki creation up to 3 times
|
||||
WIKI_OK=false
|
||||
for attempt in 1 2 3; do
|
||||
WIKI_RESULT=$(gl_run wiki +create --owner "$OWNER" --repo "$REPO_NAME" \
|
||||
--title "README" --content "$README_CONTENT" 2>&1) || true
|
||||
if [[ "$(json_ok "$WIKI_RESULT")" == "true" ]]; then
|
||||
log_ok "README created"
|
||||
WIKI_OK=true
|
||||
break
|
||||
fi
|
||||
[[ $attempt -lt 3 ]] && sleep 2
|
||||
done
|
||||
[[ "$WIKI_OK" == "false" ]] && log_warn "README wiki creation may have failed"
|
||||
|
||||
# ── Step 3: Create CONTRIBUTING Guide ────────────────────────────────
|
||||
log_step "Creating CONTRIBUTING guide..."
|
||||
|
||||
CONTRIB_CONTENT="# Contributing to $REPO_NAME
|
||||
|
||||
Thank you for your interest in contributing!
|
||||
|
||||
## How to Contribute
|
||||
|
||||
1. Fork the repository
|
||||
2. Create a feature branch: \`git checkout -b feature/my-feature\`
|
||||
3. Make your changes
|
||||
4. Run tests to ensure everything passes
|
||||
5. Commit your changes: \`git commit -m 'feat: add my feature'\`
|
||||
6. Push to your fork: \`git push origin feature/my-feature\`
|
||||
7. Create a Pull Request
|
||||
|
||||
## Code Style
|
||||
|
||||
- Follow the existing code style
|
||||
- Write meaningful commit messages
|
||||
- Add tests for new features
|
||||
- Update documentation as needed
|
||||
|
||||
## Reporting Issues
|
||||
|
||||
- Use the issue tracker
|
||||
- Include reproduction steps
|
||||
- Include environment details
|
||||
|
||||
## Code of Conduct
|
||||
|
||||
Please be respectful and constructive in all interactions."
|
||||
|
||||
# Retry wiki creation up to 3 times
|
||||
WIKI_OK=false
|
||||
for attempt in 1 2 3; do
|
||||
WIKI_CONTRIB=$(gl_run wiki +create --owner "$OWNER" --repo "$REPO_NAME" \
|
||||
--title "CONTRIBUTING" --content "$CONTRIB_CONTENT" 2>&1) || true
|
||||
if [[ "$(json_ok "$WIKI_CONTRIB")" == "true" ]]; then
|
||||
log_ok "CONTRIBUTING guide created"
|
||||
WIKI_OK=true
|
||||
break
|
||||
fi
|
||||
[[ $attempt -lt 3 ]] && sleep 2
|
||||
done
|
||||
[[ "$WIKI_OK" == "false" ]] && log_warn "CONTRIBUTING wiki creation may have failed"
|
||||
|
||||
# ── Step 4: Create Initial Issues ────────────────────────────────────
|
||||
log_step "Creating initial issues..."
|
||||
|
||||
ISSUES_TO_CREATE=(
|
||||
"Setup CI/CD Pipeline|Configure continuous integration and deployment for the project.|feature"
|
||||
"Write Project Documentation|Complete project documentation including API docs and architecture guide.|documentation"
|
||||
"Setup Code Review Process|Establish code review guidelines and automation.|enhancement"
|
||||
"Add Unit Tests|Add comprehensive unit test coverage for core modules.|enhancement"
|
||||
"Setup Dependency Management|Configure dependency scanning and updates.|security"
|
||||
)
|
||||
|
||||
for entry in "${ISSUES_TO_CREATE[@]}"; do
|
||||
IFS='|' read -r title body label <<< "$entry"
|
||||
ISSUE_RESULT=$(gl_run issue +create --owner "$OWNER" --repo "$REPO_NAME" \
|
||||
--title "$title" --body "$body" 2>&1) || true
|
||||
ISSUE_NUM=$(echo "$ISSUE_RESULT" | jq -r '.data.id // .data.number // empty')
|
||||
if [[ -n "$ISSUE_NUM" ]]; then
|
||||
# Add label
|
||||
gl_run issue +label-add --owner "$OWNER" --repo "$REPO_NAME" --number "$ISSUE_NUM" --labels "$label" > /dev/null 2>&1 || true
|
||||
log_ok "Issue created: #$ISSUE_NUM - $title"
|
||||
else
|
||||
log_warn "Issue creation may have failed: $title"
|
||||
fi
|
||||
done
|
||||
|
||||
# ── Step 5: Protect Default Branch ───────────────────────────────────
|
||||
log_step "Protecting master branch..."
|
||||
PROTECT_RESULT=$(gl_run branch +protect --owner "$OWNER" --repo "$REPO_NAME" --branch master 2>&1) || true
|
||||
|
||||
if [[ "$(json_ok "$PROTECT_RESULT")" == "true" ]]; then
|
||||
log_ok "Branch 'master' protected"
|
||||
else
|
||||
log_warn "Branch protection may have failed (may require admin permissions)"
|
||||
fi
|
||||
|
||||
# ── Step 6: Create Initial Release ───────────────────────────────────
|
||||
log_step "Creating initial release v0.1.0..."
|
||||
|
||||
RELEASE_BODY="# v0.1.0 - Initial Release
|
||||
|
||||
## What's New
|
||||
- Project initialized with $LANG template
|
||||
- README and CONTRIBUTING guides created
|
||||
- CI/CD pipeline issues filed
|
||||
- Branch protection enabled
|
||||
|
||||
## Next Steps
|
||||
- [ ] Setup CI/CD pipeline
|
||||
- [ ] Write comprehensive tests
|
||||
- [ ] Complete documentation
|
||||
- [ ] First feature implementation
|
||||
|
||||
---
|
||||
*Auto-initialized by gitlink-cli project-init workflow*"
|
||||
|
||||
RELEASE_RESULT=$(gl_run release +create --owner "$OWNER" --repo "$REPO_NAME" \
|
||||
--tag "v0.1.0" --name "Initial Release" --body "$RELEASE_BODY" 2>&1) || true
|
||||
|
||||
if [[ "$(json_ok "$RELEASE_RESULT")" == "true" ]]; then
|
||||
log_ok "Release v0.1.0 created"
|
||||
else
|
||||
log_warn "Release creation may have failed"
|
||||
fi
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
log_title "Project Initialization Complete"
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
echo -e "${GREEN}Created:${NC}"
|
||||
echo " Repository: $OWNER/$REPO_NAME"
|
||||
echo " README: Wiki page"
|
||||
echo " CONTRIBUTING: Wiki page"
|
||||
echo " Issues: ${#ISSUES_TO_CREATE[@]} initial issues"
|
||||
echo " Branch: master (protected)"
|
||||
echo " Release: v0.1.0"
|
||||
echo ""
|
||||
echo -e "${CYAN}Next steps:${NC}"
|
||||
echo " 1. Clone: git clone https://gitlink.org.cn/$OWNER/$REPO_NAME.git"
|
||||
echo " 2. Add your code and push"
|
||||
echo " 3. Setup CI/CD by closing the first issue"
|
||||
echo ""
|
||||
|
|
@ -0,0 +1,262 @@
|
|||
#!/usr/bin/env bash
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
# Scenario 4: Multi-Repo Collaboration
|
||||
# Flow: Cross-repo issue tracking → PR status dashboard → Coordinated release
|
||||
#
|
||||
# Commands/Skills chained:
|
||||
# 1. repo +list -- list all repos in org
|
||||
# 2. issue +list -- fetch issues from each repo
|
||||
# 3. pr +list -- fetch PRs from each repo
|
||||
# 4. pr +view -- get PR details for dashboard
|
||||
# 5. release +list -- check release status across repos
|
||||
# 6. release +create -- coordinated release
|
||||
# 7. Generate HTML dashboard
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
source "$SCRIPT_DIR/lib/common.sh"
|
||||
|
||||
usage() {
|
||||
echo "Usage: $0 --org ORG [--repos REPO1,REPO2,...] [--release TAG] [--dry-run]"
|
||||
echo ""
|
||||
echo " --org ORG Organization name"
|
||||
echo " --repos REPO1,REPO2 Comma-separated repo list (default: all repos in org)"
|
||||
echo " --release TAG Coordinated release tag to create"
|
||||
echo " --output FILE Output HTML dashboard file (default: dashboard.html)"
|
||||
echo " --dry-run Preview actions without executing"
|
||||
exit 1
|
||||
}
|
||||
|
||||
DRY_RUN=false
|
||||
ORG=""
|
||||
REPOS=""
|
||||
RELEASE_TAG=""
|
||||
OUTPUT_FILE="dashboard.html"
|
||||
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case "$1" in
|
||||
--org) ORG="$2"; shift 2 ;;
|
||||
--repos) REPOS="$2"; shift 2 ;;
|
||||
--release) RELEASE_TAG="$2"; shift 2 ;;
|
||||
--output) OUTPUT_FILE="$2"; shift 2 ;;
|
||||
--dry-run) DRY_RUN="true"; shift ;;
|
||||
--help|-h) usage ;;
|
||||
*) log_err "Unknown arg: $1"; usage ;;
|
||||
esac
|
||||
done
|
||||
|
||||
if [[ -z "$ORG" ]]; then
|
||||
log_err "Missing required parameter: --org"
|
||||
usage
|
||||
fi
|
||||
|
||||
check_auth
|
||||
|
||||
# ── Step 1: List Repositories ────────────────────────────────────────
|
||||
log_title "Multi-Repo Collaboration Dashboard"
|
||||
|
||||
log_step "Fetching repositories for org: $ORG..."
|
||||
REPOS_JSON=$(gl_check repo +list --owner "$ORG" --limit 100)
|
||||
ALL_REPO_COUNT=$(echo "$REPOS_JSON" | jq '.data.projects | length')
|
||||
log_ok "Found $ALL_REPO_COUNT repositories"
|
||||
|
||||
# Filter repos if --repos specified
|
||||
REPO_LIST=()
|
||||
if [[ -n "$REPOS" ]]; then
|
||||
IFS=',' read -ra REPO_LIST <<< "$REPOS"
|
||||
log_info "Filtering to specified repos: ${REPO_LIST[*]}"
|
||||
else
|
||||
for i in $(seq 0 $((ALL_REPO_COUNT - 1))); do
|
||||
RNAME=$(echo "$REPOS_JSON" | jq -r ".data.projects[$i].name // .data.projects[$i].identifier // empty")
|
||||
[[ -n "$RNAME" ]] && REPO_LIST+=("$RNAME")
|
||||
done
|
||||
fi
|
||||
|
||||
log_ok "Will process ${#REPO_LIST[@]} repositories"
|
||||
|
||||
# ── Step 2-3: Collect Issues and PRs from each repo ──────────────────
|
||||
log_title "Collecting Data Across Repos"
|
||||
|
||||
# Data arrays for dashboard
|
||||
DASHBOARD_ROWS=""
|
||||
TOTAL_ISSUES=0
|
||||
TOTAL_PRS=0
|
||||
TOTAL_OPEN_ISSUES=0
|
||||
TOTAL_OPEN_PRS=0
|
||||
|
||||
for repo in "${REPO_LIST[@]}"; do
|
||||
divider
|
||||
log_step "Processing $ORG/$repo..."
|
||||
|
||||
# Fetch open issues
|
||||
ISSUES_JSON=$(gl_run issue +list --owner "$ORG" --repo "$repo" --state open --limit 50)
|
||||
OPEN_ISSUES=$(echo "$ISSUES_JSON" | jq '.data.issues | length' 2>/dev/null || echo "0")
|
||||
|
||||
# Fetch closed issues (recent)
|
||||
CLOSED_JSON=$(gl_run issue +list --owner "$ORG" --repo "$repo" --state closed --limit 50)
|
||||
CLOSED_ISSUES=$(echo "$CLOSED_JSON" | jq '.data.issues | length' 2>/dev/null || echo "0")
|
||||
|
||||
# Fetch open PRs
|
||||
PRS_JSON=$(gl_run pr +list --owner "$ORG" --repo "$repo" --state open --limit 50)
|
||||
OPEN_PRS=$(echo "$PRS_JSON" | jq '.data.issues | length' 2>/dev/null || echo "0")
|
||||
|
||||
# Fetch merged PRs (recent)
|
||||
MERGED_JSON=$(gl_run pr +list --owner "$ORG" --repo "$repo" --state merged --limit 50)
|
||||
MERGED_PRS=$(echo "$MERGED_JSON" | jq '.data.issues | length' 2>/dev/null || echo "0")
|
||||
|
||||
# Fetch latest release
|
||||
RELEASES_JSON=$(gl_run release +list --owner "$ORG" --repo "$repo" --limit 1)
|
||||
LATEST_RELEASE=$(echo "$RELEASES_JSON" | jq -r '.data.releases[0].tag_name // .data.releases[0].name // "none"' 2>/dev/null)
|
||||
|
||||
log_ok "$repo: Issues(open:$OPEN_ISSUES closed:$CLOSED_ISSUES) PRs(open:$OPEN_PRS merged:$MERGED_PRS) Release:$LATEST_RELEASE"
|
||||
|
||||
# Get PR details for open PRs
|
||||
PR_DETAILS=""
|
||||
if [[ "$OPEN_PRS" -gt 0 ]] && [[ "$OPEN_PRS" != "null" ]]; then
|
||||
for pi in $(seq 0 $((OPEN_PRS > 5 ? 4 : OPEN_PRS - 1))); do
|
||||
PR_ID=$(echo "$PRS_JSON" | jq -r ".data.issues[$pi].pull_request_number // .data.issues[$pi].id // empty")
|
||||
PR_TITLE=$(echo "$PRS_JSON" | jq -r ".data.issues[$pi].subject // .data.issues[$pi].name // \"\"")
|
||||
PR_AUTHOR=$(echo "$PRS_JSON" | jq -r ".data.issues[$pi].author_login // .data.issues[$pi].author.login // \"unknown\"")
|
||||
PR_DETAILS+="<tr><td>#$PR_ID</td><td>$PR_TITLE</td><td>@$PR_AUTHOR</td><td>open</td></tr>"
|
||||
done
|
||||
fi
|
||||
|
||||
# Accumulate totals
|
||||
TOTAL_ISSUES=$((TOTAL_ISSUES + OPEN_ISSUES + CLOSED_ISSUES))
|
||||
TOTAL_OPEN_ISSUES=$((TOTAL_OPEN_ISSUES + OPEN_ISSUES))
|
||||
TOTAL_PRS=$((TOTAL_PRS + OPEN_PRS + MERGED_PRS))
|
||||
TOTAL_OPEN_PRS=$((TOTAL_OPEN_PRS + OPEN_PRS))
|
||||
|
||||
# Add to dashboard rows
|
||||
STATUS_COLOR="green"
|
||||
[[ "$OPEN_ISSUES" -gt 10 ]] && STATUS_COLOR="orange"
|
||||
[[ "$OPEN_ISSUES" -gt 20 ]] && STATUS_COLOR="red"
|
||||
|
||||
DASHBOARD_ROWS+="<tr>
|
||||
<td><a href=\"https://gitlink.org.cn/$ORG/$repo\">$repo</a></td>
|
||||
<td>$OPEN_ISSUES</td>
|
||||
<td>$CLOSED_ISSUES</td>
|
||||
<td>$OPEN_PRS</td>
|
||||
<td>$MERGED_PRS</td>
|
||||
<td>$LATEST_RELEASE</td>
|
||||
<td style=\"color:$STATUS_COLOR;font-weight:bold;\">$(
|
||||
[[ "$OPEN_ISSUES" -le 5 ]] && echo "Healthy" || \
|
||||
[[ "$OPEN_ISSUES" -le 15 ]] && echo "Moderate" || echo "Needs Attention"
|
||||
)</td>
|
||||
</tr>"
|
||||
done
|
||||
|
||||
# ── Step 4: Generate HTML Dashboard ──────────────────────────────────
|
||||
log_title "Generating Dashboard"
|
||||
|
||||
log_step "Creating HTML dashboard..."
|
||||
|
||||
cat > "$OUTPUT_FILE" << 'HTMLEOF'
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>Multi-Repo Collaboration Dashboard</title>
|
||||
<style>
|
||||
* { margin: 0; padding: 0; box-sizing: border-box; }
|
||||
body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; background: #f5f5f5; padding: 20px; }
|
||||
.container { max-width: 1200px; margin: 0 auto; }
|
||||
h1 { color: #333; margin-bottom: 20px; }
|
||||
.summary { display: grid; grid-template-columns: repeat(4, 1fr); gap: 16px; margin-bottom: 30px; }
|
||||
.card { background: white; border-radius: 8px; padding: 20px; box-shadow: 0 2px 4px rgba(0,0,0,0.1); }
|
||||
.card h3 { color: #666; font-size: 14px; margin-bottom: 8px; }
|
||||
.card .value { font-size: 32px; font-weight: bold; color: #333; }
|
||||
.card.blue .value { color: #2196F3; }
|
||||
.card.green .value { color: #4CAF50; }
|
||||
.card.orange .value { color: #FF9800; }
|
||||
.card.purple .value { color: #9C27B0; }
|
||||
table { width: 100%; border-collapse: collapse; background: white; border-radius: 8px; overflow: hidden; box-shadow: 0 2px 4px rgba(0,0,0,0.1); }
|
||||
th { background: #2196F3; color: white; padding: 12px 16px; text-align: left; }
|
||||
td { padding: 12px 16px; border-bottom: 1px solid #eee; }
|
||||
tr:hover { background: #f9f9f9; }
|
||||
a { color: #2196F3; text-decoration: none; }
|
||||
a:hover { text-decoration: underline; }
|
||||
.timestamp { color: #999; font-size: 14px; margin-bottom: 20px; }
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<div class="container">
|
||||
<h1>Multi-Repo Collaboration Dashboard</h1>
|
||||
<p class="timestamp">Generated: TIMESTAMP_PLACEHOLDER | Organization: ORG_PLACEHOLDER</p>
|
||||
<div class="summary">
|
||||
<div class="card blue"><h3>Total Repos</h3><div class="value">REPOS_COUNT</div></div>
|
||||
<div class="card orange"><h3>Open Issues</h3><div class="value">OPEN_ISSUES_COUNT</div></div>
|
||||
<div class="card purple"><h3>Open PRs</h3><div class="value">OPEN_PRS_COUNT</div></div>
|
||||
<div class="card green"><h3>Total Activity</h3><div class="value">TOTAL_ACTIVITY</div></div>
|
||||
</div>
|
||||
<table>
|
||||
<thead><tr><th>Repository</th><th>Open Issues</th><th>Closed Issues</th><th>Open PRs</th><th>Merged PRs</th><th>Latest Release</th><th>Health</th></tr></thead>
|
||||
<tbody>DASHBOARD_ROWS_PLACEHOLDER</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
HTMLEOF
|
||||
|
||||
# Replace placeholders using temp file approach for complex content
|
||||
TEMP_HTML=$(mktemp)
|
||||
TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')
|
||||
|
||||
while IFS= read -r line; do
|
||||
line="${line//TIMESTAMP_PLACEHOLDER/$TIMESTAMP}"
|
||||
line="${line//ORG_PLACEHOLDER/$ORG}"
|
||||
line="${line//REPOS_COUNT/${#REPO_LIST[@]}}"
|
||||
line="${line//OPEN_ISSUES_COUNT/$TOTAL_OPEN_ISSUES}"
|
||||
line="${line//OPEN_PRS_COUNT/$TOTAL_OPEN_PRS}"
|
||||
line="${line//TOTAL_ACTIVITY/$TOTAL_ISSUES}"
|
||||
line="${line//DASHBOARD_ROWS_PLACEHOLDER/$DASHBOARD_ROWS}"
|
||||
echo "$line"
|
||||
done < "$OUTPUT_FILE" > "$TEMP_HTML"
|
||||
|
||||
mv "$TEMP_HTML" "$OUTPUT_FILE"
|
||||
|
||||
log_ok "Dashboard saved to: $OUTPUT_FILE"
|
||||
|
||||
# ── Step 5: Coordinated Release ──────────────────────────────────────
|
||||
if [[ -n "$RELEASE_TAG" ]]; then
|
||||
log_title "Coordinated Release: $RELEASE_TAG"
|
||||
|
||||
RELEASE_BODY="# Coordinated Release: $RELEASE_TAG
|
||||
|
||||
## Repos Included
|
||||
"
|
||||
|
||||
for repo in "${REPO_LIST[@]}"; do
|
||||
log_step "Creating release for $ORG/$repo..."
|
||||
RELEASE_BODY+="- $ORG/$repo"$'\n'
|
||||
|
||||
RELEASE_RESULT=$(gl_run release +create --owner "$ORG" --repo "$repo" \
|
||||
--tag "$RELEASE_TAG" --name "Release $RELEASE_TAG" \
|
||||
--body "Coordinated release $RELEASE_TAG for $ORG/$repo" 2>&1) || true
|
||||
|
||||
if [[ "$(json_ok "$RELEASE_RESULT")" == "true" ]]; then
|
||||
log_ok "Release $RELEASE_TAG created for $repo"
|
||||
else
|
||||
log_warn "Release creation failed for $repo (tag may already exist)"
|
||||
fi
|
||||
done
|
||||
|
||||
RELEASE_BODY+=$'\n'"---"$'\n'"*Coordinated release by gitlink-cli multi-repo-collab workflow*"
|
||||
fi
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
log_title "Multi-Repo Dashboard Complete"
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
echo -e "${GREEN}Summary:${NC}"
|
||||
echo " Repos processed: ${#REPO_LIST[@]}"
|
||||
echo " Total issues: $TOTAL_ISSUES (open: $TOTAL_OPEN_ISSUES)"
|
||||
echo " Total PRs: $TOTAL_PRS (open: $TOTAL_OPEN_PRS)"
|
||||
echo " Dashboard: $OUTPUT_FILE"
|
||||
[[ -n "$RELEASE_TAG" ]] && echo " Coordinated release: $RELEASE_TAG"
|
||||
echo ""
|
||||
echo -e "${CYAN}Open dashboard:${NC}"
|
||||
echo " xdg-open $OUTPUT_FILE # Linux"
|
||||
echo " open $OUTPUT_FILE # macOS"
|
||||
echo ""
|
||||
|
|
@ -0,0 +1,398 @@
|
|||
#!/usr/bin/env bash
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
# Scenario 5: Contributor Growth System
|
||||
# Flow: Collect data → Calculate scores → Generate HTML → Publish Wiki
|
||||
#
|
||||
# Scoring (based on available shortcuts):
|
||||
# - Issue created: 15% weight (issue +list)
|
||||
# - PR merged: 25% weight (pr +list state=merged)
|
||||
# - Code changes: 30% weight (pr +files)
|
||||
# - Issue comments: 15% weight (issue +view)
|
||||
# - Team member: 15% weight (repo +members)
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
source "$SCRIPT_DIR/lib/common.sh"
|
||||
|
||||
usage() {
|
||||
echo "Usage: $0 --owner OWNER --repo REPO [--sample N] [--dry-run]"
|
||||
echo ""
|
||||
echo " --owner OWNER Repository owner"
|
||||
echo " --repo REPO Repository name"
|
||||
echo " --sample N Sample N PRs for code stats (default: 10)"
|
||||
echo " --dry-run Preview actions without executing"
|
||||
exit 1
|
||||
}
|
||||
|
||||
DRY_RUN=false
|
||||
OWNER=""
|
||||
REPO=""
|
||||
SAMPLE_SIZE=10
|
||||
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case "$1" in
|
||||
--owner) OWNER="$2"; shift 2 ;;
|
||||
--repo) REPO="$2"; shift 2 ;;
|
||||
--sample) SAMPLE_SIZE="$2"; shift 2 ;;
|
||||
--dry-run) DRY_RUN="true"; shift ;;
|
||||
--help|-h) usage ;;
|
||||
*) log_err "Unknown arg: $1"; usage ;;
|
||||
esac
|
||||
done
|
||||
|
||||
check_auth
|
||||
require_owner_repo
|
||||
|
||||
REPORT_FILE="contrib-report-$OWNER-$REPO.html"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
log_title "Contributor Growth System: $OWNER/$REPO"
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
# ── Step 1: Collect Data ─────────────────────────────────────────────
|
||||
log_step "Collecting data..."
|
||||
|
||||
ISSUES_OPEN=$(gl_check issue +list --owner "$OWNER" --repo "$REPO" --state open --limit 100)
|
||||
ISSUES_CLOSED=$(gl_run issue +list --owner "$OWNER" --repo "$REPO" --state closed --limit 100)
|
||||
OPEN_COUNT=$(echo "$ISSUES_OPEN" | jq '.data.issues | length' 2>/dev/null || echo "0")
|
||||
CLOSED_COUNT=$(echo "$ISSUES_CLOSED" | jq '.data.issues | length' 2>/dev/null || echo "0")
|
||||
|
||||
PRS_MERGED=$(gl_run pr +list --owner "$OWNER" --repo "$REPO" --state merged --limit 100)
|
||||
PR_MERGED_COUNT=$(echo "$PRS_MERGED" | jq '.data.issues | length' 2>/dev/null || echo "0")
|
||||
|
||||
MEMBERS=$(gl_run repo +members --owner "$OWNER" --repo "$REPO" --limit 100)
|
||||
MEMBER_COUNT=$(echo "$MEMBERS" | jq '.data.members | length' 2>/dev/null || echo "0")
|
||||
|
||||
log_ok "Issues(open:$OPEN_COUNT closed:$CLOSED_COUNT) PRs(merged:$PR_MERGED_COUNT) Members:$MEMBER_COUNT"
|
||||
|
||||
# ── Step 2: Build Contributor Data ───────────────────────────────────
|
||||
log_step "Building contributor profiles..."
|
||||
|
||||
declare -A C_ISSUES C_MERGED C_ADDITIONS C_DELETIONS C_COMMENTS C_IS_MEMBER
|
||||
|
||||
# Issues
|
||||
for i in $(seq 0 $((OPEN_COUNT - 1))); do
|
||||
A=$(echo "$ISSUES_OPEN" | jq -r ".data.issues[$i].author.login // empty")
|
||||
[[ -n "$A" ]] && C_ISSUES["$A"]=$(( ${C_ISSUES["$A"]:-0} + 1 ))
|
||||
done
|
||||
for i in $(seq 0 $((CLOSED_COUNT - 1))); do
|
||||
A=$(echo "$ISSUES_CLOSED" | jq -r ".data.issues[$i].author.login // empty")
|
||||
[[ -n "$A" ]] && C_ISSUES["$A"]=$(( ${C_ISSUES["$A"]:-0} + 1 ))
|
||||
done
|
||||
|
||||
# Merged PRs + code stats
|
||||
log_step "Analyzing PR code changes (sampling $SAMPLE_SIZE)..."
|
||||
PR_SAMPLE=$((PR_MERGED_COUNT > SAMPLE_SIZE ? SAMPLE_SIZE : PR_MERGED_COUNT))
|
||||
for i in $(seq 0 $((PR_MERGED_COUNT - 1))); do
|
||||
A=$(echo "$PRS_MERGED" | jq -r ".data.issues[$i].author_login // empty")
|
||||
ID=$(echo "$PRS_MERGED" | jq -r ".data.issues[$i].pull_request_id // .data.issues[$i].id // empty")
|
||||
[[ -n "$A" ]] && C_MERGED["$A"]=$(( ${C_MERGED["$A"]:-0} + 1 ))
|
||||
if [[ $i -lt $PR_SAMPLE ]] && [[ -n "$ID" ]]; then
|
||||
FILES=$(gl_run pr +files --owner "$OWNER" --repo "$REPO" --id "$ID" 2>&1)
|
||||
ADD=$(echo "$FILES" | jq -r '[.data.files[].addition // 0] | add // 0' 2>/dev/null || echo "0")
|
||||
DEL=$(echo "$FILES" | jq -r '[.data.files[].deletion // 0] | add // 0' 2>/dev/null || echo "0")
|
||||
[[ -n "$A" ]] && C_ADDITIONS["$A"]=$(( ${C_ADDITIONS["$A"]:-0} + ADD ))
|
||||
[[ -n "$A" ]] && C_DELETIONS["$A"]=$(( ${C_DELETIONS["$A"]:-0} + DEL ))
|
||||
fi
|
||||
done
|
||||
|
||||
# Members
|
||||
for i in $(seq 0 $((MEMBER_COUNT - 1))); do
|
||||
L=$(echo "$MEMBERS" | jq -r ".data.members[$i].login // empty")
|
||||
[[ -n "$L" ]] && C_IS_MEMBER["$L"]="yes"
|
||||
done
|
||||
|
||||
# Comments (sample)
|
||||
log_step "Sampling issue comments..."
|
||||
for i in $(seq 0 $((OPEN_COUNT > 10 ? 9 : OPEN_COUNT - 1))); do
|
||||
ID=$(echo "$ISSUES_OPEN" | jq -r ".data.issues[$i].id // empty")
|
||||
[[ -z "$ID" ]] && continue
|
||||
DETAIL=$(gl_run issue +view --owner "$OWNER" --repo "$REPO" --number "$ID" 2>&1)
|
||||
C=$(echo "$DETAIL" | jq -r '.data.comment_journals_count // 0' 2>/dev/null || echo "0")
|
||||
if [[ "$C" -gt 0 ]]; then
|
||||
A=$(echo "$ISSUES_OPEN" | jq -r ".data.issues[$i].author.login // empty")
|
||||
[[ -n "$A" ]] && C_COMMENTS["$A"]=$(( ${C_COMMENTS["$A"]:-0} + C ))
|
||||
fi
|
||||
done
|
||||
|
||||
# ── Step 3: Calculate Scores ─────────────────────────────────────────
|
||||
log_step "Calculating scores..."
|
||||
|
||||
declare -A SCORES
|
||||
ALL_USERS=()
|
||||
for user in "${!C_ISSUES[@]}" "${!C_MERGED[@]}" "${!C_COMMENTS[@]}"; do
|
||||
[[ -n "$user" ]] && ALL_USERS+=("$user")
|
||||
done
|
||||
ALL_USERS=($(printf '%s\n' "${ALL_USERS[@]}" | sort -u))
|
||||
|
||||
MAX_ISSUES=0; MAX_MERGED=0; MAX_LINES=0; MAX_COMMENTS=0
|
||||
for user in "${ALL_USERS[@]}"; do
|
||||
[[ ${C_ISSUES[$user]:-0} -gt $MAX_ISSUES ]] && MAX_ISSUES=${C_ISSUES[$user]}
|
||||
[[ ${C_MERGED[$user]:-0} -gt $MAX_MERGED ]] && MAX_MERGED=${C_MERGED[$user]}
|
||||
LINES=$(( ${C_ADDITIONS[$user]:-0} + ${C_DELETIONS[$user]:-0} ))
|
||||
[[ $LINES -gt $MAX_LINES ]] && MAX_LINES=$LINES
|
||||
[[ ${C_COMMENTS[$user]:-0} -gt $MAX_COMMENTS ]] && MAX_COMMENTS=${C_COMMENTS[$user]}
|
||||
done
|
||||
|
||||
for user in "${ALL_USERS[@]}"; do
|
||||
SCORE=$(awk -v iss="${C_ISSUES[$user]:-0}" -v mi="$MAX_ISSUES" \
|
||||
-v mer="${C_MERGED[$user]:-0}" -v mm="$MAX_MERGED" \
|
||||
-v lin="$(( ${C_ADDITIONS[$user]:-0} + ${C_DELETIONS[$user]:-0} ))" -v ml="$MAX_LINES" \
|
||||
-v com="${C_COMMENTS[$user]:-0}" -v mc="$MAX_COMMENTS" \
|
||||
-v mem="${C_IS_MEMBER[$user]:-no}" \
|
||||
'BEGIN {
|
||||
ni=(mi>0)?iss/mi:0; nm=(mm>0)?mer/mm:0; nl=(ml>0)?lin/ml:0; nc=(mc>0)?com/mc:0; ms=(mem=="yes")?1:0;
|
||||
printf "%.1f", (ni*15+nm*25+nl*30+nc*15+ms*15)
|
||||
}')
|
||||
SCORES["$user"]="$SCORE"
|
||||
done
|
||||
|
||||
# ── Step 4: Display Rankings ─────────────────────────────────────────
|
||||
log_title "Contributor Rankings"
|
||||
echo ""
|
||||
printf " ${BOLD}%-4s %-18s %-8s %-8s %-12s %-10s %-8s %s${NC}\n" "Rank" "Contributor" "Issues" "Merged" "+/- Lines" "Comments" "Score" "Badge"
|
||||
echo " ──── ─────────────────── ──────── ──────── ──────────── ────────── ──────── ─────────────"
|
||||
|
||||
TEMP=$(mktemp)
|
||||
for u in "${!SCORES[@]}"; do echo "${SCORES[$u]} $u" >> "$TEMP"; done
|
||||
|
||||
RANK=1
|
||||
sort -rn "$TEMP" | while read -r score user; do
|
||||
iss=${C_ISSUES[$user]:-0}; mer=${C_MERGED[$user]:-0}
|
||||
add=${C_ADDITIONS[$user]:-0}; del=${C_DELETIONS[$user]:-0}
|
||||
com=${C_COMMENTS[$user]:-0}; si=${score%.*}
|
||||
if [[ $si -ge 80 ]]; then B="Champion"
|
||||
elif [[ $si -ge 60 ]]; then B="Core Contributor"
|
||||
elif [[ $si -ge 40 ]]; then B="Active Contributor"
|
||||
elif [[ $si -ge 20 ]]; then B="Contributor"
|
||||
else B="Newcomer"
|
||||
fi
|
||||
printf " %-4d %-18s %-8d %-8d +%-6d/-%-4d %-10d %-8s %s\n" "$RANK" "$user" "$iss" "$mer" "$add" "$del" "$com" "$score" "$B"
|
||||
RANK=$((RANK + 1))
|
||||
done
|
||||
rm -f "$TEMP"
|
||||
|
||||
# ── Step 5: Generate HTML Report ─────────────────────────────────────
|
||||
log_title "Generating HTML Report"
|
||||
|
||||
# Build JSON data for charts
|
||||
PIE_DATA=""
|
||||
TABLE_ROWS=""
|
||||
RANK=1
|
||||
|
||||
TEMP2=$(mktemp)
|
||||
for u in "${!SCORES[@]}"; do echo "${SCORES[$u]} $u" >> "$TEMP2"; done
|
||||
|
||||
sort -rn "$TEMP2" | while read -r score user; do
|
||||
iss=${C_ISSUES[$user]:-0}; mer=${C_MERGED[$user]:-0}
|
||||
add=${C_ADDITIONS[$user]:-0}; del=${C_DELETIONS[$user]:-0}
|
||||
lin=$((add + del)); com=${C_COMMENTS[$user]:-0}
|
||||
si=${score%.*}
|
||||
if [[ $si -ge 80 ]]; then B="Champion"
|
||||
elif [[ $si -ge 60 ]]; then B="Core Contributor"
|
||||
elif [[ $si -ge 40 ]]; then B="Active Contributor"
|
||||
elif [[ $si -ge 20 ]]; then B="Contributor"
|
||||
else B="Newcomer"
|
||||
fi
|
||||
# Output as CSV for processing
|
||||
echo "$RANK|$user|$iss|$mer|$lin|$com|$score|$B|$add|$del"
|
||||
RANK=$((RANK + 1))
|
||||
done > "$TEMP2.csv"
|
||||
rm -f "$TEMP2"
|
||||
|
||||
# Generate HTML
|
||||
cat > "$REPORT_FILE" << 'HTMLHEAD'
|
||||
<!DOCTYPE html>
|
||||
<html lang="zh-CN">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>Contributor Report</title>
|
||||
<script src="https://cdn.jsdelivr.net/npm/echarts@5.4.3/dist/echarts.min.js"></script>
|
||||
<style>
|
||||
* { margin: 0; padding: 0; box-sizing: border-box; }
|
||||
body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); min-height: 100vh; padding: 40px 20px; }
|
||||
.container { max-width: 1200px; margin: 0 auto; }
|
||||
.header { text-align: center; color: white; margin-bottom: 40px; }
|
||||
.header h1 { font-size: 2.5rem; margin-bottom: 10px; text-shadow: 2px 2px 4px rgba(0,0,0,0.3); }
|
||||
.header p { font-size: 1.1rem; opacity: 0.9; }
|
||||
.card { background: white; border-radius: 16px; box-shadow: 0 20px 60px rgba(0,0,0,0.3); padding: 30px; margin-bottom: 30px; }
|
||||
.card h2 { color: #333; margin-bottom: 20px; font-size: 1.5rem; border-bottom: 3px solid #667eea; padding-bottom: 10px; }
|
||||
.stats-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 20px; margin-bottom: 30px; }
|
||||
.stat-card { background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); border-radius: 12px; padding: 20px; color: white; text-align: center; }
|
||||
.stat-value { font-size: 2rem; font-weight: bold; margin-bottom: 5px; }
|
||||
.stat-label { font-size: 0.9rem; opacity: 0.9; }
|
||||
table { width: 100%; border-collapse: collapse; margin-top: 20px; }
|
||||
th { background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); color: white; padding: 15px 12px; text-align: left; font-size: 0.85rem; text-transform: uppercase; letter-spacing: 1px; }
|
||||
td { padding: 12px; border-bottom: 1px solid #eee; }
|
||||
tr:hover { background: #f8f9ff; }
|
||||
.rank { font-weight: bold; color: #667eea; font-size: 1.2rem; }
|
||||
.rank-1 { color: #FFD700; }
|
||||
.rank-2 { color: #C0C0C0; }
|
||||
.rank-3 { color: #CD7F32; }
|
||||
.badge { padding: 4px 12px; border-radius: 20px; font-size: 0.8rem; font-weight: 600; }
|
||||
.badge-champion { background: #FFD700; color: #333; }
|
||||
.badge-core { background: #C0C0C0; color: #333; }
|
||||
.badge-active { background: #CD7F32; color: white; }
|
||||
.badge-contributor { background: #4CAF50; color: white; }
|
||||
.badge-newcomer { background: #9E9E9E; color: white; }
|
||||
.chart-container { width: 100%; height: 400px; }
|
||||
.weight-info { background: #f8f9ff; border-radius: 12px; padding: 20px; margin-top: 20px; }
|
||||
.weight-info h3 { color: #667eea; margin-bottom: 15px; }
|
||||
.weight-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 10px; }
|
||||
.weight-item { display: flex; justify-content: space-between; padding: 8px 12px; background: white; border-radius: 8px; border-left: 4px solid #667eea; }
|
||||
.weight-label { color: #666; }
|
||||
.weight-value { font-weight: 600; color: #667eea; }
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<div class="container">
|
||||
<div class="header">
|
||||
<h1>Contributor Report</h1>
|
||||
HTMLHEAD
|
||||
|
||||
echo " <p>$OWNER/$REPO - Team Contribution Analysis</p>" >> "$REPORT_FILE"
|
||||
echo " </div>" >> "$REPORT_FILE"
|
||||
|
||||
# Stats cards
|
||||
TOTAL_ISSUES=$((OPEN_COUNT + CLOSED_COUNT))
|
||||
echo " <div class=\"stats-grid\">" >> "$REPORT_FILE"
|
||||
echo " <div class=\"stat-card\"><div class=\"stat-value\">${#SCORES[@]}</div><div class=\"stat-label\">Contributors</div></div>" >> "$REPORT_FILE"
|
||||
echo " <div class=\"stat-card\"><div class=\"stat-value\">$TOTAL_ISSUES</div><div class=\"stat-label\">Total Issues</div></div>" >> "$REPORT_FILE"
|
||||
echo " <div class=\"stat-card\"><div class=\"stat-value\">$PR_MERGED_COUNT</div><div class=\"stat-label\">Merged PRs</div></div>" >> "$REPORT_FILE"
|
||||
echo " </div>" >> "$REPORT_FILE"
|
||||
|
||||
# Pie chart
|
||||
echo " <div class=\"card\">" >> "$REPORT_FILE"
|
||||
echo " <h2>Score Distribution</h2>" >> "$REPORT_FILE"
|
||||
echo " <div id=\"pieChart\" class=\"chart-container\"></div>" >> "$REPORT_FILE"
|
||||
echo " </div>" >> "$REPORT_FILE"
|
||||
|
||||
# Rankings table
|
||||
echo " <div class=\"card\">" >> "$REPORT_FILE"
|
||||
echo " <h2>Detailed Rankings</h2>" >> "$REPORT_FILE"
|
||||
echo " <table><thead><tr><th>Rank</th><th>Contributor</th><th>Issues</th><th>Merged PRs</th><th>Code Lines</th><th>Comments</th><th>Score</th><th>Badge</th></tr></thead><tbody>" >> "$REPORT_FILE"
|
||||
|
||||
PIE_JSON=""
|
||||
while IFS='|' read -r rank user iss mer lin com score badge add del; do
|
||||
cls=""; [[ $rank -eq 1 ]] && cls=" rank-1"
|
||||
[[ $rank -eq 2 ]] && cls=" rank-2"
|
||||
[[ $rank -eq 3 ]] && cls=" rank-3"
|
||||
|
||||
badge_cls="newcomer"
|
||||
[[ "$badge" == "Champion" ]] && badge_cls="champion"
|
||||
[[ "$badge" == "Core Contributor" ]] && badge_cls="core"
|
||||
[[ "$badge" == "Active Contributor" ]] && badge_cls="active"
|
||||
[[ "$badge" == "Contributor" ]] && badge_cls="contributor"
|
||||
|
||||
echo " <tr><td class=\"rank$cls\">$rank</td><td>@$user</td><td>$iss</td><td>$mer</td><td>$lin</td><td>$com</td><td>$score</td><td><span class=\"badge badge-$badge_cls\">$badge</span></td></tr>" >> "$REPORT_FILE"
|
||||
PIE_JSON+="{value: $score, name: '$user'},"
|
||||
done < "$TEMP2.csv"
|
||||
|
||||
echo " </tbody></table>" >> "$REPORT_FILE"
|
||||
echo " </div>" >> "$REPORT_FILE"
|
||||
|
||||
# Weight info
|
||||
echo " <div class=\"card\">" >> "$REPORT_FILE"
|
||||
echo " <h2>Scoring System (AHP Weights)</h2>" >> "$REPORT_FILE"
|
||||
echo " <div class=\"weight-info\">" >> "$REPORT_FILE"
|
||||
echo " <div class=\"weight-grid\">" >> "$REPORT_FILE"
|
||||
echo " <div class=\"weight-item\"><span class=\"weight-label\">Issues Created</span><span class=\"weight-value\">15%</span></div>" >> "$REPORT_FILE"
|
||||
echo " <div class=\"weight-item\"><span class=\"weight-label\">PRs Merged</span><span class=\"weight-value\">25%</span></div>" >> "$REPORT_FILE"
|
||||
echo " <div class=\"weight-item\"><span class=\"weight-label\">Code Changes</span><span class=\"weight-value\">30%</span></div>" >> "$REPORT_FILE"
|
||||
echo " <div class=\"weight-item\"><span class=\"weight-label\">Issue Comments</span><span class=\"weight-value\">15%</span></div>" >> "$REPORT_FILE"
|
||||
echo " <div class=\"weight-item\"><span class=\"weight-label\">Team Member</span><span class=\"weight-value\">15%</span></div>" >> "$REPORT_FILE"
|
||||
echo " </div>" >> "$REPORT_FILE"
|
||||
echo " </div>" >> "$REPORT_FILE"
|
||||
echo " </div>" >> "$REPORT_FILE"
|
||||
|
||||
# JavaScript
|
||||
cat >> "$REPORT_FILE" << HTMLFOOT
|
||||
</div>
|
||||
<script>
|
||||
var chart = echarts.init(document.getElementById('pieChart'));
|
||||
chart.setOption({
|
||||
tooltip: { trigger: 'item', formatter: '{a} <br/>{b}: {c} ({d}%)' },
|
||||
legend: { orient: 'vertical', left: 'left', top: 'middle' },
|
||||
series: [{
|
||||
name: 'Score',
|
||||
type: 'pie',
|
||||
radius: ['40%', '70%'],
|
||||
center: ['60%', '50%'],
|
||||
itemStyle: { borderRadius: 10, borderColor: '#fff', borderWidth: 2 },
|
||||
label: { show: true, formatter: '{b}\\n{d}%' },
|
||||
data: [$PIE_JSON]
|
||||
}]
|
||||
});
|
||||
window.addEventListener('resize', () => chart.resize());
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
HTMLFOOT
|
||||
|
||||
rm -f "$TEMP2.csv"
|
||||
log_ok "HTML report: $REPORT_FILE"
|
||||
|
||||
# ── Step 6: Publish to Wiki ──────────────────────────────────────────
|
||||
log_step "Publishing to Wiki..."
|
||||
|
||||
WIKI_CONTENT="# Contributor Leaderboard - $OWNER/$REPO
|
||||
|
||||
*Generated: $(date '+%Y-%m-%d %H:%M')*
|
||||
|
||||
## Scoring System
|
||||
|
||||
| Dimension | Weight | Source |
|
||||
|-----------|--------|--------|
|
||||
| Issues Created | 15% | \`issue +list\` |
|
||||
| PRs Merged | 25% | \`pr +list state=merged\` |
|
||||
| Code Changes | 30% | \`pr +files\` |
|
||||
| Issue Comments | 15% | \`issue +view\` |
|
||||
| Team Member | 15% | \`repo +members\` |
|
||||
|
||||
## Rankings
|
||||
|
||||
| Rank | Contributor | Issues | Merged | Lines | Comments | Score | Badge |
|
||||
|------|-------------|--------|--------|-------|----------|-------|-------|
|
||||
"
|
||||
|
||||
TEMP3=$(mktemp)
|
||||
for u in "${!SCORES[@]}"; do echo "${SCORES[$u]} $u" >> "$TEMP3"; done
|
||||
RANK=1
|
||||
sort -rn "$TEMP3" | while read -r score user; do
|
||||
iss=${C_ISSUES[$user]:-0}; mer=${C_MERGED[$user]:-0}
|
||||
lin=$(( ${C_ADDITIONS[$user]:-0} + ${C_DELETIONS[$user]:-0} ))
|
||||
com=${C_COMMENTS[$user]:-0}; si=${score%.*}
|
||||
if [[ $si -ge 80 ]]; then B="Champion"
|
||||
elif [[ $si -ge 60 ]]; then B="Core"
|
||||
elif [[ $si -ge 40 ]]; then B="Active"
|
||||
elif [[ $si -ge 20 ]]; then B="Contributor"
|
||||
else B="Newcomer"
|
||||
fi
|
||||
echo "| $RANK | @$user | $iss | $mer | $lin | $com | $score | $B |"
|
||||
RANK=$((RANK + 1))
|
||||
done > "$TEMP3.rows"
|
||||
WIKI_CONTENT+=$(cat "$TEMP3.rows")
|
||||
rm -f "$TEMP3" "$TEMP3.rows"
|
||||
|
||||
WIKI_CONTENT+="
|
||||
|
||||
---
|
||||
*Auto-generated by gitlink-cli*"
|
||||
|
||||
# Use timestamp to avoid title conflicts with cached deletions
|
||||
WIKI_TITLE="Contributor Leaderboard $(date '+%Y-%m-%d')"
|
||||
WIKI_RESULT=$(gl_run wiki +create --owner "$OWNER" --repo "$REPO" \
|
||||
--title "$WIKI_TITLE" --content "$WIKI_CONTENT" 2>&1) || true
|
||||
|
||||
if [[ "$(json_ok "$WIKI_RESULT")" == "true" ]]; then
|
||||
log_ok "Published to Wiki: $WIKI_TITLE"
|
||||
else
|
||||
log_warn "Wiki publish failed"
|
||||
fi
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────
|
||||
log_title "Complete"
|
||||
echo " Contributors: ${#SCORES[@]}"
|
||||
echo " HTML Report: $REPORT_FILE"
|
||||
echo ""
|
||||
|
|
@ -0,0 +1,515 @@
|
|||
# GitLink CLI 工作流自动化
|
||||
|
||||
5 个端到端自动化场景，将 gitlink-cli 的 shortcut 命令串联成完整工作流，解决实际项目管理痛点。
|
||||
|
||||
---
|
||||
|
||||
## 环境准备
|
||||
|
||||
### 1. 安装 gitlink-cli
|
||||
|
||||
```bash
|
||||
# 确认已安装
|
||||
gitlink-cli version
|
||||
|
||||
# 未安装则从项目根目录构建
|
||||
cd /home/kevin/gitlink-cli
|
||||
make build
|
||||
```
|
||||
|
||||
### 2. 安装 jq
|
||||
|
||||
脚本用 `jq` 解析 CLI 返回的 JSON。
|
||||
|
||||
```bash
|
||||
# Ubuntu/Debian
|
||||
sudo apt-get install -y jq
|
||||
|
||||
# macOS
|
||||
brew install jq
|
||||
```
|
||||
|
||||
### 3. 登录认证
|
||||
|
||||
```bash
|
||||
# 方式一：交互式登录（推荐）
|
||||
gitlink-cli auth login
|
||||
|
||||
# 方式二：环境变量
|
||||
export GITLINK_TOKEN="你的私人令牌"
|
||||
# 令牌获取：https://gitlink.org.cn → 个人设置 → 私人令牌
|
||||
|
||||
# 验证
|
||||
gitlink-cli auth status
|
||||
# 应显示：✓ Logged in as 用户名
|
||||
```
|
||||
|
||||
### 4. 验证环境
|
||||
|
||||
```bash
|
||||
# 测试 JSON 输出是否正常
|
||||
gitlink-cli issue +list --owner zzx-coder --repo gitlink-cli --state open --limit 3 --format json | jq '.ok'
|
||||
# 应输出：true
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 五个场景
|
||||
|
||||
| # | 场景 | 脚本 | 串联命令 | 解决什么问题 |
|
||||
|---|------|------|---------|-------------|
|
||||
| 1 | 社区运营自动化 | `01-community-ops.sh` | 7 个 | Issue 积压无人处理、周报手写、Release Notes 手动整理 |
|
||||
| 2 | 代码质量看门人 | `02-code-quality-gatekeeper.sh` | 7 个 | PR 审查效率低、质量标准不统一、AI 代码审查（基于 gitlink-code-review skill） |
|
||||
| 3 | 项目一键初始化 | `03-project-init.sh` | 6 个 | 新建项目重复劳动多、Issue/文档/分支保护手动配 |
|
||||
| 4 | 多仓库协同 | `04-multi-repo-collab.sh` | 7 个 | 跨仓库状态分散、缺乏统一视图 |
|
||||
| 5 | 贡献者成长体系 | `05-contributor-growth.sh` | 6 个 | 贡献者活跃度难追踪、缺乏激励机制 |
|
||||
|
||||
---
|
||||
|
||||
## 场景一：社区运营自动化
|
||||
|
||||
**脚本**: `01-community-ops.sh`
|
||||
|
||||
### 解决什么问题
|
||||
|
||||
新 Issue 没人分类、不知道谁该负责、社区周报手写、发版时才手忙脚乱写 Release Notes。
|
||||
|
||||
### 工作流程
|
||||
|
||||
```
|
||||
issue +list → 读取所有 open Issue
|
||||
↓
|
||||
按关键词分类: Bug / Feature / Question / Docs
|
||||
↓
|
||||
issue +label-add → 自动打标签
|
||||
↓
|
||||
repo +members → 获取仓库成员列表
|
||||
issue +update → 轮询分配负责人
|
||||
↓
|
||||
pr +list → 统计本周合并的 PR
|
||||
issue +list → 统计本周关闭的 Issue
|
||||
↓
|
||||
wiki +create → 发布社区周报到 Wiki
|
||||
↓
|
||||
release +create → 自动生成 Release Notes
|
||||
```
|
||||
|
||||
### 串联的命令
|
||||
|
||||
| 步骤 | 命令 | 作用 |
|
||||
|------|------|------|
|
||||
| 1 | `issue +list` | 获取所有 open Issue |
|
||||
| 2 | `issue +label-add` | 按分类打标签 (bug/feature/question/documentation) |
|
||||
| 3 | `repo +members` | 获取仓库成员列表 |
|
||||
| 4 | `issue +update` | 给 Bug/Feature Issue 分配负责人 |
|
||||
| 5 | `pr +list` | 统计本周合并的 PR |
|
||||
| 6 | `wiki +create` | 发布社区周报 |
|
||||
| 7 | `release +create` | 自动生成 Release Notes |
|
||||
|
||||
### 输出有什么用
|
||||
|
||||
- **标签分类**: 仓库 Issue 页面可按标签筛选，一目了然
|
||||
- **负责人分配**: 每个 Issue 有明确负责人，避免互相推诿
|
||||
- **Wiki 周报**: 团队和社区用户可在 Wiki 查看每周进展
|
||||
- **Release Notes**: 发版时无需手动整理变更
|
||||
|
||||
### 运行
|
||||
|
||||
```bash
|
||||
bash workflows/01-community-ops.sh --owner 你的组织 --repo 你的仓库
|
||||
|
||||
# 示例
|
||||
bash workflows/01-community-ops.sh --owner zzx-coder --repo gitlink-cli
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 场景二：代码质量看门人
|
||||
|
||||
**脚本**: `02-code-quality-gatekeeper.sh`
|
||||
|
||||
### 解决什么问题
|
||||
|
||||
PR 审查是代码质量的核心环节，但人工审查耗时且标准不统一。这个工作流加载 **gitlink-code-review skill** 的审查方法论，用 AI (Claude) 对 PR 进行四维度代码审查，自动打分评级，达标后自动合并。
|
||||
|
||||
### 工作流程
|
||||
|
||||
```
|
||||
pr +list → 获取所有 open PR
|
||||
↓
|
||||
pr +view → 读取 PR 详情
|
||||
pr +files → 获取变更文件列表
|
||||
pr +diff → 获取代码差异
|
||||
↓
|
||||
加载 gitlink-code-review skill:
|
||||
- 审查维度与检查项
|
||||
- 评分标准 (90-100 优秀, 75-89 良好, ...)
|
||||
- 问题严重级别 (CRITICAL/HIGH/MEDIUM/LOW)
|
||||
↓
|
||||
┌─────────────────────────────────────┐
|
||||
│ AI 代码审查 (Claude + Skill) │
|
||||
│ 四维度评分 (各 0-25，总分 100): │
|
||||
│ - 代码质量: 复杂度、命名、注释 │
|
||||
│ - 安全性: SQL注入、XSS、敏感信息 │
|
||||
│ - 性能: 循环效率、资源泄漏、N+1 │
|
||||
│ - 可维护性: 重复、职责单一、耦合 │
|
||||
│ │
|
||||
│ 输出: │
|
||||
│ - 结构化问题清单 (severity+file+ │
|
||||
│ rule+description+suggestion) │
|
||||
│ - 优秀实践 (positive_notes) │
|
||||
│ - 改进建议 (recommendations) │
|
||||
│ - 总分 + PASS/FAIL │
|
||||
└─────────────────────────────────────┘
|
||||
↓
|
||||
api POST /reviews → 发布审查评论到 PR
|
||||
↓
|
||||
ci +builds → 检查 CI 构建状态
|
||||
↓
|
||||
pr +merge → 分数 >= 阈值 且 CI 通过 → 自动合并
|
||||
```
|
||||
|
||||
### AI 审查示例输出（基于 gitlink-code-review skill）
|
||||
|
||||
```
|
||||
Overall Score: 88 / 100
|
||||
Code Quality: 23 / 25
|
||||
Security: 25 / 25
|
||||
Performance: 20 / 25
|
||||
Maintainability: 20 / 25
|
||||
|
||||
Issues Found:
|
||||
- [LOW] quality: 条目格式说明中 PR 条目用 (@作者) 带括号，commit 条目用 (作者名) 不带 @ 前缀
|
||||
→ 统一格式规范，建议 commit 条目也使用 (@作者) 格式
|
||||
- [LOW] maintainability: 示例中贡献者列表变更但完整变更日志链接仍指向旧仓库
|
||||
→ 将变更日志链接中的 OWNER 也更新为与示例贡献者一致
|
||||
|
||||
Positive Notes:
|
||||
+ 变更目的清晰，所有文件的修改一致地贯彻了需求，无遗漏
|
||||
+ 变更范围合理，仅修改文档和示例，不涉及代码逻辑变更，风险极低
|
||||
|
||||
Recommendations:
|
||||
> 统一 PR 条目和 commit 条目的作者标注格式
|
||||
> 在 collect-data.md 中补充 author 字段为空时的降级处理说明
|
||||
```
|
||||
|
||||
### 串联的命令
|
||||
|
||||
| 步骤 | 命令 | 作用 |
|
||||
|------|------|------|
|
||||
| 1 | `pr +list` | 获取 open PR 列表 |
|
||||
| 2 | `pr +view` | 读取 PR 详情（标题、作者、状态） |
|
||||
| 3 | `pr +files` | 获取变更文件列表 |
|
||||
| 4 | `pr +diff` | 获取代码差异内容 |
|
||||
| 5 | `gitlink-code-review` | 加载 skill 的审查维度、检查项、评分标准 |
|
||||
| 6 | `claude -p` | AI 按 skill 方法论进行四维度代码审查 |
|
||||
| 7 | `api POST .../reviews` | 将审查评论发布到 PR |
|
||||
| 8 | `pr +merge` | 质量分 >= 阈值且 CI 通过时自动合并 |
|
||||
|
||||
### 输出有什么用
|
||||
|
||||
- **结构化评分**: 每个 PR 有 0-100 的质量评分，团队可设定统一合并门槛
|
||||
- **AI 问题清单**: 自动列出安全隐患、性能问题、代码质量问题，人工审查时重点关注
|
||||
- **PR 评论**: 审查结果直接评论在 PR 上，作者和审查者都能看到
|
||||
- **自动合并**: 高质量 PR 无需人工点击
|
||||
|
||||
### 运行
|
||||
|
||||
```bash
|
||||
# 审查所有 open PR
|
||||
bash workflows/02-code-quality-gatekeeper.sh --owner 你的组织 --repo 你的仓库
|
||||
|
||||
# 审查指定 PR
|
||||
bash workflows/02-code-quality-gatekeeper.sh --owner 你的组织 --repo 你的仓库 --pr-id 42
|
||||
|
||||
# 自定义质量阈值（默认 80）
|
||||
bash workflows/02-code-quality-gatekeeper.sh --owner 你的组织 --repo 你的仓库 --threshold 70
|
||||
|
||||
# 预览模式（不实际合并）
|
||||
bash workflows/02-code-quality-gatekeeper.sh --owner 你的组织 --repo 你的仓库 --dry-run
|
||||
|
||||
# 示例
|
||||
bash workflows/02-code-quality-gatekeeper.sh --owner zzx-coder --repo gitlink-cli --pr-id 20
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 场景三：项目一键初始化
|
||||
|
||||
**脚本**: `03-project-init.sh`
|
||||
|
||||
### 解决什么问题
|
||||
|
||||
新建项目仓库后，还要手动创建 README、写 CONTRIBUTING 指南、创建初始 Issue、设置分支保护、打初始 Release。一条命令搞定全部。
|
||||
|
||||
### 工作流程
|
||||
|
||||
```
|
||||
repo +create → 创建仓库
|
||||
↓
|
||||
wiki +create → 生成 README（根据语言模板）
|
||||
wiki +create → 生成 CONTRIBUTING 贡献指南
|
||||
↓
|
||||
issue +create × 5 → 创建初始待办 Issue:
|
||||
- 搭建 CI/CD 流水线
|
||||
- 编写项目文档
|
||||
- 建立代码审查流程
|
||||
- 添加单元测试
|
||||
- 配置依赖管理
|
||||
↓
|
||||
branch +protect → 保护 master 分支
|
||||
↓
|
||||
release +create → 创建 v0.1.0 初始版本
|
||||
```
|
||||
|
||||
### 串联的命令
|
||||
|
||||
| 步骤 | 命令 | 作用 |
|
||||
|------|------|------|
|
||||
| 1 | `repo +create` | 创建新仓库 |
|
||||
| 2 | `wiki +create` | 生成 README（支持 Go/Python/Node/Java） |
|
||||
| 3 | `wiki +create` | 生成 CONTRIBUTING 贡献指南 |
|
||||
| 4 | `issue +create` | 创建 5 个初始 Issue 并打标签 |
|
||||
| 5 | `branch +protect` | 设置 master 分支保护规则 |
|
||||
| 6 | `release +create` | 创建 v0.1.0 初始版本 |
|
||||
|
||||
### 输出有什么用
|
||||
|
||||
- **开箱即用**: 新成员克隆后就知道怎么构建、测试、贡献
|
||||
- **标准化 Issue**: 关键待办已创建好，团队可直接认领
|
||||
- **分支保护**: 防止直接 push 到 master，强制走 PR 流程
|
||||
- **首个 Release**: 项目从创建之初就有版本管理
|
||||
|
||||
### 运行
|
||||
|
||||
```bash
|
||||
# Go 项目
|
||||
bash workflows/03-project-init.sh --owner 你的组织 --name my-go-app --description "我的Go应用" --lang go
|
||||
|
||||
# Python 项目（私有）
|
||||
bash workflows/03-project-init.sh --owner 你的组织 --name my-api --description "REST API服务" --lang python --private
|
||||
|
||||
# Node.js 项目
|
||||
bash workflows/03-project-init.sh --owner 你的组织 --name my-web --description "Web前端" --lang node
|
||||
|
||||
# Java 项目
|
||||
bash workflows/03-project-init.sh --owner 你的组织 --name my-service --description "微服务" --lang java
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 场景四：多仓库协同
|
||||
|
||||
**脚本**: `04-multi-repo-collab.sh`
|
||||
|
||||
### 解决什么问题
|
||||
|
||||
当一个组织有多个仓库时，管理者需要逐个查看每个仓库的 Issue、PR、Release 状态。这个工作流汇总所有仓库数据，生成一个 HTML 仪表盘，并支持一键协调发版。
|
||||
|
||||
### 工作流程
|
||||
|
||||
```
|
||||
repo +list → 列出组织下所有仓库
|
||||
↓
|
||||
对每个仓库:
|
||||
issue +list → 获取 open/closed Issue
|
||||
pr +list → 获取 open/merged PR
|
||||
release +list → 获取最新 Release
|
||||
↓
|
||||
生成 HTML 仪表盘:
|
||||
- 总览卡片: 仓库数、Open Issue、Open PR、总活动量
|
||||
- 详情表格: 每个仓库的 Issue/PR/Release 状态
|
||||
- 健康度: Healthy / Moderate / Needs Attention
|
||||
↓
|
||||
（可选）release +create → 一键为所有仓库创建同一版本号的 Release
|
||||
```
|
||||
|
||||
### 串联的命令
|
||||
|
||||
| 步骤 | 命令 | 作用 |
|
||||
|------|------|------|
|
||||
| 1 | `repo +list` | 列出组织下所有仓库 |
|
||||
| 2 | `issue +list` | 获取每个仓库的 Issue 数据 |
|
||||
| 3 | `pr +list` | 获取每个仓库的 PR 数据 |
|
||||
| 4 | `release +list` | 获取每个仓库的最新 Release |
|
||||
| 5 | 生成 HTML | 输出可视化仪表盘 |
|
||||
| 6 | `release +create` | （可选）协调发版 |
|
||||
|
||||
### 输出有什么用
|
||||
|
||||
- **统一视图**: 一个 HTML 页面看到组织所有仓库的健康状态
|
||||
- **健康度预警**: Open Issue 超 10 个标橙色，超 20 个标红色
|
||||
- **协调发版**: 多个关联仓库需要同步发版时，一条命令搞定
|
||||
- **可分享**: HTML 文件可直接发给团队或部署到内部网站
|
||||
|
||||
### 运行
|
||||
|
||||
```bash
|
||||
# 扫描组织下所有仓库
|
||||
bash workflows/04-multi-repo-collab.sh --org 你的组织
|
||||
|
||||
# 只看指定仓库
|
||||
bash workflows/04-multi-repo-collab.sh --org 你的组织 --repos "repo-a,repo-b,repo-c"
|
||||
|
||||
# 生成仪表盘 + 协调发版
|
||||
bash workflows/04-multi-repo-collab.sh --org 你的组织 --release v2.0.0
|
||||
|
||||
# 自定义输出文件
|
||||
bash workflows/04-multi-repo-collab.sh --org 你的组织 --output my-dashboard.html
|
||||
|
||||
# 示例
|
||||
bash workflows/04-multi-repo-collab.sh --org zzx-coder
|
||||
```
|
||||
|
||||
运行后在当前目录生成 `dashboard.html`，浏览器打开即可查看。
|
||||
|
||||
---
|
||||
|
||||
## 场景五：贡献者成长体系
|
||||
|
||||
**脚本**: `05-contributor-growth.sh`
|
||||
|
||||
### 解决什么问题
|
||||
|
||||
开源项目需要激励贡献者持续参与，但很难量化每个人的贡献。这个工作流自动追踪贡献者活动，计算贡献分数，生成排行榜，并可选自动颁发成就徽章。
|
||||
|
||||
### 工作流程
|
||||
|
||||
```
|
||||
contrib +report → 生成带 ECharts 饼图的 HTML 贡献报告
|
||||
↓
|
||||
issue +list → 统计 Issue 活动
|
||||
pr +list → 统计 PR 活动
|
||||
api GET /contributors → 获取提交数等 API 统计
|
||||
↓
|
||||
计算贡献分数 (AHP 权重模型):
|
||||
- PR 被合并: 10 分
|
||||
- 提交 PR: 5 分
|
||||
- 创建/解决 Issue: 3 分
|
||||
- 代码提交: 2 分
|
||||
↓
|
||||
评定等级:
|
||||
Champion (冠军) >= 50 分
|
||||
Core Contributor >= 30 分
|
||||
Active Contributor >= 15 分
|
||||
Contributor >= 5 分
|
||||
Newcomer (新人) < 5 分
|
||||
↓
|
||||
（可选）issue +create → 自动创建徽章颁发 Issue
|
||||
↓
|
||||
wiki +create → 发布排行榜到 Wiki
|
||||
```
|
||||
|
||||
### 串联的命令
|
||||
|
||||
| 步骤 | 命令 | 作用 |
|
||||
|------|------|------|
|
||||
| 1 | `contrib +report` | 生成 HTML 贡献报告（带 ECharts 图表） |
|
||||
| 2 | `issue +list` | 统计 open/closed Issue 活动 |
|
||||
| 3 | `pr +list` | 统计 open/merged PR 活动 |
|
||||
| 4 | `api GET /contributors` | 获取 API 级别的贡献者统计 |
|
||||
| 5 | `issue +create` | （可选）自动颁发成就徽章 |
|
||||
| 6 | `wiki +create` | 发布排行榜到 Wiki |
|
||||
|
||||
### 输出有什么用
|
||||
|
||||
- **HTML 贡献报告**: 可视化展示贡献分布，适合团队会议演示
|
||||
- **贡献排行榜**: 量化每个人的贡献，公开透明
|
||||
- **Wiki 排行榜**: 永久保存，贡献者可随时查看排名
|
||||
- **徽章激励**: 通过 Issue 颁发徽章，增强成就感和归属感
|
||||
|
||||
### 运行
|
||||
|
||||
```bash
|
||||
# 基本运行
|
||||
bash workflows/05-contributor-growth.sh --owner 你的组织 --repo 你的仓库
|
||||
|
||||
# 自定义统计周期（默认 30 天）
|
||||
bash workflows/05-contributor-growth.sh --owner 你的组织 --repo 你的仓库 --period 90
|
||||
|
||||
# 启用自动颁发徽章
|
||||
bash workflows/05-contributor-growth.sh --owner 你的组织 --repo 你的仓库 --award
|
||||
|
||||
# 示例
|
||||
bash workflows/05-contributor-growth.sh --owner zzx-coder --repo gitlink-cli --award
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 通用参数
|
||||
|
||||
| 参数 | 说明 |
|
||||
|------|------|
|
||||
| `--owner OWNER` | 仓库所属组织或用户（在 git 仓库内可自动检测） |
|
||||
| `--repo REPO` | 仓库名称（在 git 仓库内可自动检测） |
|
||||
| `--dry-run` | 预览模式，不实际执行写操作 |
|
||||
| `--help` | 显示帮助信息 |
|
||||
|
||||
---
|
||||
|
||||
## 项目结构
|
||||
|
||||
```
|
||||
workflows/
|
||||
├── lib/
|
||||
│ └── common.sh # 共享工具库（认证、JSON解析、CLI封装、日志）
|
||||
├── 01-community-ops.sh # 场景一：社区运营自动化
|
||||
├── 02-code-quality-gatekeeper.sh # 场景二：代码质量看门人（AI审查）
|
||||
├── 03-project-init.sh # 场景三：项目一键初始化
|
||||
├── 04-multi-repo-collab.sh # 场景四：多仓库协同
|
||||
├── 05-contributor-growth.sh # 场景五：贡献者成长体系
|
||||
├── test.sh # 测试套件
|
||||
└── README.md # 本文档
|
||||
```
|
||||
|
||||
### 共享库 `lib/common.sh`
|
||||
|
||||
所有脚本共享的基础设施：
|
||||
|
||||
| 函数 | 作用 |
|
||||
|------|------|
|
||||
| `check_auth` | 检查认证状态（环境变量 或 CLI 登录） |
|
||||
| `gl_run` | CLI 封装，自动追加 `--format json` |
|
||||
| `gl_check` | CLI 封装 + JSON 格式校验 + ok 字段检查 |
|
||||
| `json_ok` / `json_get` / `json_error` | JSON 解析工具 |
|
||||
| `detect_owner_repo` | 从 git remote 自动检测 owner/repo |
|
||||
| `log_step` / `log_ok` / `log_warn` / `log_err` | 彩色日志输出 |
|
||||
|
||||
---
|
||||
|
||||
## 涉及的 Skill
|
||||
|
||||
工作流通过加载 Skill 的审查方法论、分类规则和模板来指导 AI 分析：
|
||||
|
||||
| Skill | 被哪个场景使用 | 作用 |
|
||||
|-------|-------------|------|
|
||||
| `gitlink-code-review` | 场景 2 | **已集成** — 加载审查维度、检查项、评分标准，指导 AI 代码审查 |
|
||||
| `gitlink-issue-triage` | 场景 1 | Issue 分类规则（关键词匹配、优先级判定） |
|
||||
| `gitlink-changelog` | 场景 1 | Release Notes 生成模板（按类型分组、贡献者列表） |
|
||||
| `gitlink-health` | 场景 4 | 项目健康度评分体系（100 分制） |
|
||||
| `gitlink-onboard` | 场景 5 | 新人引导和 Issue 推荐规则 |
|
||||
| `gitlink-workflow` | 全部 | 基础工作流编排（Issue 分类、PR 审查、发版、Sprint 报告） |
|
||||
|
||||
> 场景 2 的 `gitlink-code-review` skill 已完整集成：脚本运行时自动从 `skills/gitlink-code-review/SKILL.md` 加载审查维度和检查项，传给 AI 作为审查方法论。其他场景使用关键词匹配等规则引擎。
|
||||
|
||||
---
|
||||
|
||||
## 测试
|
||||
|
||||
```bash
|
||||
# 运行测试套件（使用真实 GitLink 仓库验证）
|
||||
bash workflows/test.sh
|
||||
|
||||
# 指定仓库
|
||||
bash workflows/test.sh zzx-coder gitlink-cli
|
||||
```
|
||||
|
||||
测试覆盖：
|
||||
- 认证状态检查
|
||||
- CLI JSON 输出格式验证
|
||||
- 数据字段提取（issue/PR/repo/release/member/contributor）
|
||||
- PR 文件和 Diff 内容解析
|
||||
- Issue/PR View 接口
|
||||
- Wiki / Label 列表接口
|
||||
- common.sh 工具函数
|
||||
- 所有脚本语法校验
|
||||
|
|
@ -0,0 +1,164 @@
|
|||
#!/usr/bin/env bash
|
||||
# Common utilities for gitlink-cli workflow scripts
|
||||
|
||||
set -euo pipefail
|
||||
# Trap SIGPIPE to prevent premature exit when piping through head/truncate
|
||||
trap '' PIPE
|
||||
|
||||
# Ensure jq is available (WinGet installs to non-default PATH on Windows)
|
||||
if ! command -v jq &>/dev/null; then
|
||||
for d in "$LOCALAPPDATA/Microsoft/WinGet/Links" "$HOME/AppData/Local/Microsoft/WinGet/Links"; do
|
||||
[[ -d "$d" ]] && export PATH="$d:$PATH"
|
||||
done
|
||||
fi
|
||||
|
||||
# Colors
|
||||
RED='\033[0;31m'
|
||||
GREEN='\033[0;32m'
|
||||
YELLOW='\033[1;33m'
|
||||
BLUE='\033[0;34m'
|
||||
CYAN='\033[0;36m'
|
||||
BOLD='\033[1m'
|
||||
NC='\033[0m'
|
||||
|
||||
# ── Logging ──────────────────────────────────────────────────────────
|
||||
log_step() { echo -e "${BLUE}[STEP]${NC} $*"; }
|
||||
log_ok() { echo -e "${GREEN}[ OK]${NC} $*"; }
|
||||
log_warn() { echo -e "${YELLOW}[WARN]${NC} $*"; }
|
||||
log_err() { echo -e "${RED}[ ERR]${NC} $*" >&2; }
|
||||
log_info() { echo -e "${CYAN}[INFO]${NC} $*"; }
|
||||
log_title(){ echo -e "\n${BOLD}══════ $* ══════${NC}\n"; }
|
||||
|
||||
# ── Auth Check ───────────────────────────────────────────────────────
|
||||
check_auth() {
|
||||
# Check env var first, then try CLI auth status
|
||||
if [[ -n "${GITLINK_TOKEN:-}" ]]; then
|
||||
log_ok "GITLINK_TOKEN is set"
|
||||
return 0
|
||||
fi
|
||||
local status
|
||||
status=$(gitlink-cli auth status 2>&1)
|
||||
if echo "$status" | grep -qi "logged in\|✓"; then
|
||||
log_ok "Authenticated: $(echo "$status" | sed -n 's/.*as //p' | tr -d '[:space:]')"
|
||||
return 0
|
||||
fi
|
||||
log_err "Not authenticated. Please login first:"
|
||||
log_info " gitlink-cli auth login"
|
||||
log_info " export GITLINK_TOKEN=\"your-private-token\""
|
||||
exit 1
|
||||
}
|
||||
|
||||
# ── JSON Helpers ─────────────────────────────────────────────────────
|
||||
# Extract a field from CLI JSON output (Envelope: {ok, data, ...})
|
||||
json_ok() {
|
||||
echo "$1" | jq -r '.ok // false' 2>/dev/null
|
||||
}
|
||||
|
||||
json_data() {
|
||||
echo "$1" | jq -r '.data' 2>/dev/null
|
||||
}
|
||||
|
||||
json_get() {
|
||||
echo "$1" | jq -r "$2" 2>/dev/null
|
||||
}
|
||||
|
||||
json_error() {
|
||||
echo "$1" | jq -r '.error.message // "unknown error"' 2>/dev/null
|
||||
}
|
||||
|
||||
# ── CLI Wrapper ──────────────────────────────────────────────────────
|
||||
GL="gitlink-cli"
|
||||
|
||||
gl_run() {
|
||||
local output
|
||||
# Always use JSON format for scripting
|
||||
output=$("$GL" "$@" --format json 2>&1) || true
|
||||
echo "$output"
|
||||
}
|
||||
|
||||
gl_check() {
|
||||
local output
|
||||
output=$(gl_run "$@")
|
||||
# Check if output is valid JSON (use here-string to avoid SIGPIPE)
|
||||
if ! jq empty <<< "$output" 2>/dev/null; then
|
||||
log_err "Command failed (non-JSON response): $GL $*"
|
||||
log_err "$output"
|
||||
return 1
|
||||
fi
|
||||
if [[ "$(json_ok "$output")" != "true" ]]; then
|
||||
log_err "Command failed: $GL $*"
|
||||
log_err "$(json_error "$output")"
|
||||
return 1
|
||||
fi
|
||||
echo "$output"
|
||||
}
|
||||
|
||||
# ── Owner/Repo Detection ────────────────────────────────────────────
|
||||
detect_owner_repo() {
|
||||
local remote_url
|
||||
remote_url=$(git remote get-url origin 2>/dev/null || echo "")
|
||||
if [[ -z "$remote_url" ]]; then
|
||||
log_err "No git remote 'origin' found. Use --owner and --repo flags."
|
||||
exit 1
|
||||
fi
|
||||
# Parse gitlink URL patterns
|
||||
# https://gitlink.org.cn/owner/repo.git or git@gitlink.org.cn:owner/repo.git
|
||||
if [[ "$remote_url" =~ gitlink\.org\.cn[:/]([^/]+)/([^/.]+) ]]; then
|
||||
DETECTED_OWNER="${BASH_REMATCH[1]}"
|
||||
DETECTED_REPO="${BASH_REMATCH[2]}"
|
||||
else
|
||||
log_err "Cannot parse owner/repo from remote: $remote_url"
|
||||
exit 1
|
||||
fi
|
||||
}
|
||||
|
||||
require_owner_repo() {
|
||||
if [[ -z "${OWNER:-}" || -z "${REPO:-}" ]]; then
|
||||
detect_owner_repo
|
||||
OWNER="${OWNER:-$DETECTED_OWNER}"
|
||||
REPO="${REPO:-$DETECTED_REPO}"
|
||||
fi
|
||||
log_info "Using: ${OWNER}/${REPO}"
|
||||
}
|
||||
|
||||
# ── Confirmation ─────────────────────────────────────────────────────
|
||||
confirm() {
|
||||
local msg="${1:-Proceed?}"
|
||||
if [[ "${DRY_RUN:-false}" == "true" ]]; then
|
||||
log_warn "[DRY RUN] Would execute: $msg"
|
||||
return 1
|
||||
fi
|
||||
read -rp "$(echo -e "${YELLOW}$msg [y/N]${NC} ")" answer
|
||||
[[ "$answer" =~ ^[Yy] ]]
|
||||
}
|
||||
|
||||
# ── Date Helpers ─────────────────────────────────────────────────────
|
||||
date_today() {
|
||||
date +%Y-%m-%d
|
||||
}
|
||||
|
||||
date_week_ago() {
|
||||
date -d "7 days ago" +%Y-%m-%d 2>/dev/null || date -v-7d +%Y-%m-%d 2>/dev/null
|
||||
}
|
||||
|
||||
date_month_ago() {
|
||||
date -d "30 days ago" +%Y-%m-%d 2>/dev/null || date -v-30d +%Y-%m-%d 2>/dev/null
|
||||
}
|
||||
|
||||
# ── Parameter Parsing ────────────────────────────────────────────────
|
||||
parse_common_args() {
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case "$1" in
|
||||
--owner) OWNER="$2"; shift 2 ;;
|
||||
--repo) REPO="$2"; shift 2 ;;
|
||||
--dry-run) DRY_RUN="true"; shift ;;
|
||||
--help|-h) usage; exit 0 ;;
|
||||
*) break ;;
|
||||
esac
|
||||
done
|
||||
}
|
||||
|
||||
# ── Section Divider ──────────────────────────────────────────────────
|
||||
divider() {
|
||||
echo -e "${CYAN}────────────────────────────────────────────────${NC}"
|
||||
}
|
||||
Loading…
Reference in New Issue