From 82ff856e468dc5c811705e1cbbec51364640b9a2 Mon Sep 17 00:00:00 2001
From: zhangqing <1770666340@qq.com>
Date: Thu, 2 Jul 2026 19:14:55 +0800
Subject: [PATCH] =?UTF-8?q?docs(workflows):=20=E7=A7=BB=E9=99=A4=20zhangqi?=
 =?UTF-8?q?ng=20=E4=BB=BB=E5=8A=A1=E4=B8=89=E8=84=9A=E6=9C=AC=E4=BA=A7?=
 =?UTF-8?q?=E7=89=A9=EF=BC=8C=E6=94=B9=E8=B5=B0=E7=BC=96=E6=8E=92=20Skill?=
 =?UTF-8?q?=20=E8=B7=AF=E7=BA=BF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

按任务三"全部是 Markdown 文档（编排 Skill），不写 Go 代码、不写 shell 脚本"的核心原则：
- 删除 reproduce.sh 及 payload-v0.2.0-beta.2.json
- 同步修订 README.md 与 agent-dialogue-triggers.md 中对脚本的引用
远端 GitLink 已发布的 Release/Issue/Label/评论不受影响（脚本写入早在 2026-06-29 落地）。
下一步用编排 Skill（SKILL.md）串联任务二子 Skill 实现 ①⑤⑦ 工作流。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 examples/workflows/zhangqing-task3/README.md  |   9 +-
 .../agent-dialogue-triggers.md                |  10 -
 .../payload-v0.2.0-beta.2.json                |   7 -
 .../workflows/zhangqing-task3/reproduce.sh    | 181 ------------------
 4 files changed, 1 insertion(+), 206 deletions(-)
 delete mode 100644 examples/workflows/zhangqing-task3/payload-v0.2.0-beta.2.json
 delete mode 100644 examples/workflows/zhangqing-task3/reproduce.sh

diff --git a/examples/workflows/zhangqing-task3/README.md b/examples/workflows/zhangqing-task3/README.md
index 921d9e6..99feb72 100644
--- a/examples/workflows/zhangqing-task3/README.md
+++ b/examples/workflows/zhangqing-task3/README.md
@@ -31,19 +31,12 @@
 | `07-onboarding-nanny.md` | ⑦ 新人保姆 5 步执行报告 |
 | `release-notes-v0.2.0-beta.1.md` | ① 发布的 Release Notes 全文 |
 | `agent-dialogue-triggers.md` | **Agent 对话触发语**（PDF 首要产物：演示 Skill 驱动 Agent） |
-| `reproduce.sh` | **可复现脚本**（评委照着跑） |
 
 ---
 
 ## 怎么复现
 
-```bash
-cd <gitlink-cli 仓库根目录>
-# 前置：已构建 gitlink-cli.exe、已 auth login、对 ylly/gitlink-cli 有写权限
-bash examples/workflows/zhangqing-task3/reproduce.sh
-```
-
-脚本标注了 `[READ]`（只读）和 `[WRITE]`（写入）段，评委可选择只跑只读段验证流程。
+复现方式见 [`agent-dialogue-triggers.md`](agent-dialogue-triggers.md)：在 Claude Code 里粘贴触发语，让 Agent 加载任务二的 Skill 来串联执行 ①⑤⑦ 三个工作流，把对话过程截图即为 PDF 要求的「Agent 对话记录」产物（PDF「正确做法」明确：Agent 对话记录是首要产物）。
 
 ---
 
diff --git a/examples/workflows/zhangqing-task3/agent-dialogue-triggers.md b/examples/workflows/zhangqing-task3/agent-dialogue-triggers.md
index 53118f8..c1f2da1 100644
--- a/examples/workflows/zhangqing-task3/agent-dialogue-triggers.md
+++ b/examples/workflows/zhangqing-task3/agent-dialogue-triggers.md
@@ -117,13 +117,3 @@ gitlink-cli.exe 在 C:/Users/Lenovo/Desktop/gitlink-cli/ 目录下，已 auth lo
 3. **命令调用**：Agent 调 gitlink-cli 的命令行（带参数）
 4. **真实写入回执**：服务器返回的 `ok:true` / `id` / `version_id` 等
 5. **网页验证**：复制返回的 URL 到浏览器打开看到真实效果
-
----
-
-## 与 reproduce.sh 的关系
-
-| 产物 | 角色 | 适合谁看 |
-|------|------|---------|
-| **Agent 对话记录**（本文档触发的） | 首要产物，演示"Skill 驱动 Agent" | 评委看过程 |
-| `reproduce.sh` | 辅助产物，纯命令复现 | 评委验结果 |
-| 3 份执行报告 | 落地证据，含 Skill 蓝图对照 | 评委查细节 |
diff --git a/examples/workflows/zhangqing-task3/payload-v0.2.0-beta.2.json b/examples/workflows/zhangqing-task3/payload-v0.2.0-beta.2.json
deleted file mode 100644
index 089683f..0000000
--- a/examples/workflows/zhangqing-task3/payload-v0.2.0-beta.2.json
+++ /dev/null
@@ -1,7 +0,0 @@
-{
-  "tag_name": "v0.2.0-beta.2",
-  "name": "v0.2.0 Beta 2 - 任务三交付补强（预发布）",
-  "body": "> 本版本为 **v0.2.0-beta.1 的补强预发布**。在 beta.1 基础上补充「Skill 蓝图对照」与「Agent 对话触发语」两类交付物，验证 PDF「Skill 作为设计蓝图、Agent 对话作为首要产物」的要求。\n>\n> 正式版 v0.2.0 将在任务三 7 个工作流全部完工后由整合者发布。\n\n## v0.2.0 Beta 2 — 任务三交付补强版（预发布）\n\n本版本是 beta.1 的迭代补强，重点回答 PDF「正确做法」对任务三的核心要求：**Skill 不是摆设，是真正驱动 Agent 执行的设计蓝图；Agent 对话记录是首要产物，脚本是辅助。**\n\n### 📚 文档 · Skill 蓝图对照补强\n\n- docs(workflows): zhangqing 任务三 ①⑤⑦ 三份执行报告各新增「Skill 蓝图对照」段，**逐动作引用 SKILL.md 行号**，证明每步执行都严格按蓝图落地\n- docs(workflows): README 新增「Skill 作为设计蓝图」总览表，集中展示 9 个执行动作到 SKILL.md 行号的映射\n- docs(workflows): 新增 `agent-dialogue-triggers.md` — 给评委的 Agent 对话触发语，含 ①⑤⑦ 三个工作流的单条/分步触发语，演示 Skill 自动加载\n\n### 🎯 覆盖的 Skill 蓝图行号映射\n\n| 工作流 | SKILL.md 蓝图位置 |\n|--------|------------------|\n| ① 步骤 1 分类 | `gitlink-issue-triage/SKILL.md` 工作流 1（第 54-117 行）|\n| ① 步骤 3 周报 | `gitlink-insight/SKILL.md` 工作流 2（第 116-166 行）|\n| ① 步骤 4 发版 | `gitlink-release-auto/SKILL.md` 一/二/三（第 32-189 行）|\n| ⑤ 取数 + 发奖 | `gitlink-insight/SKILL.md` 工作流 3（第 169-203 行）+ `gitlink-issue-triage` 工作流 1（第 80-117 行）|\n| ⑦ 识别 + 引导 | `gitlink-onboarding/SKILL.md` 工作流 1（第 50-95 行）+ 工作流 2（第 99-145 行）|\n\n### 🤝 贡献者\n\n感谢以下贡献者参与本版本开发：@zhangqing\n",
-  "target_commitish": "master",
-  "prerelease": true
-}
diff --git a/examples/workflows/zhangqing-task3/reproduce.sh b/examples/workflows/zhangqing-task3/reproduce.sh
deleted file mode 100644
index 5fb48e1..0000000
--- a/examples/workflows/zhangqing-task3/reproduce.sh
+++ /dev/null
@@ -1,181 +0,0 @@
-#!/usr/bin/env bash
-# ============================================================
-# 任务三 zhangqing 工作流可复现脚本（① ⑤ ⑦）
-# ============================================================
-# 用法：
-#   cd <path-to>/gitlink-cli
-#   bash reproduce.sh
-#
-# 前置：
-#   1. gitlink-cli.exe 已构建并在 PATH 或当前目录
-#   2. 已运行 gitlink-cli auth login 登录（token 存 keychain）
-#   3. 当前账号对 ylly/gitlink-cli 有 Manager 权限
-#
-# 注意：脚本含写入操作（发版/建 label/建 Issue/发评论），
-#       评委可选择只跑只读段（标注 [READ]），跳过写入段（标注 [WRITE]）。
-# ============================================================
-
-set -e
-OWNER=ylly
-REPO=gitlink-cli
-CLI="./gitlink-cli.exe"
-WORKDIR="$(mktemp -d)"
-echo "工作目录: $WORKDIR"
-
-# ============================================================
-# 工作流 ① 社区运营自动化
-# ============================================================
-echo ""
-echo "========================"
-echo " 工作流 ① 社区运营自动化"
-echo "========================"
-
-# --- [READ] 步骤1：列出未分类 Issue ---
-echo "[①-1] 列出开放 Issue..."
-$CLI issue +list --owner $OWNER --repo $REPO --state open --format json > "$WORKDIR/issues_open.json"
-
-# --- [READ] 步骤2：查 assigners（演示识别平台限制）---
-echo "[①-2] 查 assigners 候选（已知返回空——GitLink 平台限制）..."
-$CLI issue +assigners --owner $OWNER --repo $REPO --format json > "$WORKDIR/assigners.json" || true
-
-# --- [READ] 步骤3：采集周报数据 ---
-echo "[①-3] 采集周报数据..."
-$CLI issue +list --owner $OWNER --repo $REPO --state closed --format json > "$WORKDIR/issues_closed.json"
-$CLI pr +list --owner $OWNER --repo $REPO --state merged --format json > "$WORKDIR/prs_merged.json"
-$CLI release +list --owner $OWNER --repo $REPO --format json > "$WORKDIR/releases.json"
-
-# --- [WRITE] 步骤4：发版 v0.2.0-beta.1（预发布）---
-echo "[①-4] 生成 Release Notes 并发版（WRITE）..."
-PYTHONIOENCODING=utf-8 python <<PYEOF
-import json
-body = """## v0.2.0 Beta 1 - 智能运营能力升级版（预发布）
-
-### 新功能 · Skills 智能套件
-- gitlink-issue-triage / gitlink-release-auto / gitlink-commit-quality
-- gitlink-code-review / gitlink-insight / gitlink-compliance
-- 文档智能维护 + 新人引导
-
-### 新功能 · Shortcut 命令扩展
-- wiki / label / notification / member / milestone / compare / pr / webhook / repo / issue
-- api --body-file（解决 Windows 中文编码）
-
-### Bug 修复
-- notification / issue --label / wiki gateway / label path / pr closed time
-"""
-payload = {
-    "tag_name": "v0.2.0-beta.1",
-    "name": "v0.2.0 Beta 1 - 任务三阶段版（预发布）",
-    "body": body,
-    "target_commitish": "master",
-    "prerelease": True,
-}
-with open(r"$WORKDIR/release_payload.json", "w", encoding="utf-8") as f:
-    json.dump(payload, f, ensure_ascii=False)
-PYEOF
-MSYS_NO_PATHCONV=1 $CLI api POST /$OWNER/$REPO/releases --body-file "$WORKDIR/release_payload.json" --format json
-
-# 验证发版
-echo "[①-4-verify] 验证发版..."
-$CLI release +list --owner $OWNER --repo $REPO --format json > "$WORKDIR/releases_after.json"
-
-# ============================================================
-# 工作流 ⑤ 贡献者成长体系
-# ============================================================
-echo ""
-echo "========================"
-echo " 工作流 ⑤ 贡献者成长体系"
-echo "========================"
-
-# --- [READ] 步骤1：采集贡献数据 ---
-echo "[⑤-1] 采集贡献者数据..."
-git log --format="%an" | sort | uniq -c | sort -rn > "$WORKDIR/commits.txt"
-
-# --- [READ] 步骤2：生成排行榜（见 contributor_leaderboard.md）---
-echo "[⑤-2] 排行榜已生成 → 见交付包 contributor_leaderboard.md"
-
-# --- [WRITE] 步骤3a：创建 3 个徽章 label ---
-echo "[⑤-3a] 创建 3 个徽章 label（WRITE）..."
-PYTHONIOENCODING=utf-8 python <<PYEOF
-import json
-for i, (name, color) in enumerate([
-    ("星级贡献者", "#FFD700"),
-    ("活跃贡献者", "#FF6B35"),
-    ("贡献者", "#87C95F"),
-]):
-    with open(r"$WORKDIR/label_$i.json", "w", encoding="utf-8") as f:
-        json.dump({"name": name, "color": color}, f, ensure_ascii=False)
-PYEOF
-for i in 0 1 2; do
-  MSYS_NO_PATHCONV=1 $CLI api POST /$OWNER/$REPO/labels --body-file "$WORKDIR/label_$i.json" --format json
-done
-
-# --- [WRITE] 步骤3b：创建颁奖 Issue ---
-echo "[⑤-3b] 创建颁奖 Issue（WRITE）..."
-PYTHONIOENCODING=utf-8 python <<PYEOF
-import json
-body = "完整排行榜见 contributor_leaderboard.md"
-payload = {
-    "subject": "🏆 v0.2.0-beta.1 贡献者排行榜公布",
-    "description": body,
-    "priority_id": 2,
-    "done_ratio": 0,  # 关键：必须传，否则 MySQL 报错
-    "issue_tag_ids": [394180],  # 星级贡献者 label ID（需先用 label +list 拿）
-}
-with open(r"$WORKDIR/issue_award.json", "w", encoding="utf-8") as f:
-    json.dump(payload, f, ensure_ascii=False)
-PYEOF
-MSYS_NO_PATHCONV=1 $CLI api POST /$OWNER/$REPO/issues --body-file "$WORKDIR/issue_award.json" --format json
-
-# ============================================================
-# 工作流 ⑦ 新人全流程保姆
-# ============================================================
-echo ""
-echo "========================"
-echo " 工作流 ⑦ 新人全流程保姆"
-echo "========================"
-
-# --- [READ] 步骤1：演示邀请能力 ---
-echo "[⑦-1] 演示 member 邀请能力..."
-$CLI member +list --owner $OWNER --repo $REPO --format json > "$WORKDIR/members.json"
-$CLI member +invite-link --owner $OWNER --repo $REPO --format json > "$WORKDIR/invite.json"
-
-# --- [READ] 步骤2：扫描 + 识别 good first issue ---
-echo "[⑦-2] good first 识别（AI 评估每个 Issue）..."
-$CLI issue +list --owner $OWNER --repo $REPO --state open --format json > "$WORKDIR/open_issues.json"
-echo "    → onboarding Skill 评估：现有 #8/#13/#14 good first 标记合理，无遗漏"
-
-# --- [WRITE] 步骤3：发引导评论到 good first Issue ---
-echo "[⑦-3] 发个性化引导评论到 #8/#13/#14（WRITE）..."
-PYTHONIOENCODING=utf-8 python <<PYEOF
-import json
-comments = {
-    8: "👋 欢迎贡献！任务：补 wiki 命令使用示例。入手：README.zh-CN.md + shortcuts/wiki/wiki.go",
-    13: "👋 欢迎贡献！任务：补 Windows go build 说明。入手：参考 Makefile + scripts/build-npm.sh",
-    14: "👋 欢迎贡献！任务：补 wiki +list 字段说明。入手：跑 wiki +list --format json 拿真实数据",
-}
-for n, c in comments.items():
-    with open(rf"$WORKDIR/comment_{n}.json", "w", encoding="utf-8") as f:
-        json.dump({"notes": c}, f, ensure_ascii=False)
-PYEOF
-# 关键：journals endpoint 必须 /v1 前缀，否则 404
-for n in 8 13 14; do
-  MSYS_NO_PATHCONV=1 $CLI api POST /v1/$OWNER/$REPO/issues/$n/journals --body-file "$WORKDIR/comment_$n.json" --format json
-done
-
-# --- [READ] 步骤4：通知系统 ---
-echo "[⑦-4] 查看通知系统..."
-$CLI notification +list --owner zhangqing23 --limit 10 --format json > "$WORKDIR/notifs.json"
-
-# --- [READ] 步骤5：跟踪首次贡献 ---
-echo "[⑦-5] 跟踪首次贡献（数据已在 notifs.json + prs_merged.json）..."
-echo "    → ZxR123-Z: 加入(1月前) → 提PR(2天前) → merged(2天前) → 完成首次贡献"
-
-echo ""
-echo "========================"
-echo " 全部完成"
-echo "========================"
-echo "产物在: $WORKDIR/"
-echo "公开可见成果："
-echo "  - Release v0.2.0-beta.1 (version_id=2218)"
-echo "  - Issue #17 颁奖 + 3 个徽章 label (394180/394181/394182)"
-echo "  - #8/#13/#14 各 1 条引导评论"