Gitlink
/
gitlink-cli
0
0
Fork 49
Code Issues Pull Requests 11 Packages Projects Releases 10 Wiki Activity

feat(skills): 新增 gitlink-doc-sync 中英文档一致性守护 Skill #331

Merged
wbtiger merged 1 commits from Taoyouce/gitlink-cli:feat/doc-sync-skill into master 2026-07-14 20:37:57 +08:00
Conversation 0 Commits 1 Files Changed 1 +136
Taoyouce commented 2026-07-05 17:44:59 +08:00
Contributor
Copy Link

背景

开源项目普遍维护中英双语文档（本仓库即有 README.md + README.zh-CN.md），但两个版本极易漂移：英文更新了新功能，中文没跟上。现有 44 个 Skill 无一覆盖文档翻译一致性场景。

内容

新增 gitlink-doc-sync Skill，提供完整的双语文档守护工作流：

  1. 文档对发现 — 用 repo +tree / file +search 按命名约定自动识别双语文档对
  2. 漂移检测 — file +view --raw 拉取两版内容，AI 逐节比对结构与新鲜度（缺失章节/滞后章节/示例不一致/版本号漂移），并用提交历史佐证哪一侧滞后
  3. 漂移报告 — 输出分级（?/?/?）报告，先报告后动手
  4. 同步修复 — 经用户确认后 file +update --new-branch + pr +create 走 PR 流程，附翻译原则（术语不译、代码块逐字一致等）
  5. 发版前审计 — 与 release 流程配合，严重漂移时提醒暂缓发版

安全设计

  • 只读命令可直接执行；写操作必须先出报告并确认
  • 同步修复一律提交到新分支走 PR，禁止直推主分支
  • 报告必须给出具体位置与证据

依赖 file 快捷命令组（PR #330）；在 #330 合并前，file +view/+update 步骤亦可用 Raw API 等价替代。

## 背景 开源项目普遍维护中英双语文档（本仓库即有 README.md + README.zh-CN.md），但两个版本极易漂移：英文更新了新功能，中文没跟上。现有 44 个 Skill 无一覆盖文档翻译一致性场景。 ## 内容 新增 `gitlink-doc-sync` Skill，提供完整的双语文档守护工作流： 1. **文档对发现** — 用 `repo +tree` / `file +search` 按命名约定自动识别双语文档对 2. **漂移检测** — `file +view --raw` 拉取两版内容，AI 逐节比对结构与新鲜度（缺失章节/滞后章节/示例不一致/版本号漂移），并用提交历史佐证哪一侧滞后 3. **漂移报告** — 输出分级（?/?/?）报告，先报告后动手 4. **同步修复** — 经用户确认后 `file +update --new-branch` + `pr +create` 走 PR 流程，附翻译原则（术语不译、代码块逐字一致等） 5. **发版前审计** — 与 release 流程配合，严重漂移时提醒暂缓发版 ## 安全设计 - 只读命令可直接执行；写操作必须先出报告并确认 - 同步修复一律提交到新分支走 PR，禁止直推主分支 - 报告必须给出具体位置与证据 依赖 `file` 快捷命令组（PR #330）；在 #330 合并前，`file +view/+update` 步骤亦可用 Raw API 等价替代。
Taoyouce added 1 commit 2026-07-05 17:45:00 +08:00
f3c90a52d7 feat(skills): 新增 gitlink-doc-sync 中英文档一致性守护 Skill 
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
wbtiger merged commit 90db109422 into master 2026-07-14 20:37:43 +08:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No Label
Milestone
Clear milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: Gitlink/gitlink-cli#331
No description provided.
Delete Branch "Taoyouce/gitlink-cli:feat/doc-sync-skill"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?