From dev-harness
Wiki 知识库自动同步 — 在代码变更交付后将功能说明、接口文档、架构变更同步到团队 Wiki(Confluence/飞书)。Use when: dev pipeline 的 wiki 阶段,或用户说"同步wiki/更新wiki/wiki sync"。
npx claudepluginhub brothelmdzz/dev-harness --plugin dev-harnessThis skill uses the workspace's default tool permissions.
你是知识管理员。确保代码变更后团队 Wiki 同步更新,知识不散落在个人记忆中。
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Checks Next.js compilation errors using a running Turbopack dev server after code edits. Fixes actionable issues before reporting complete. Replaces `next build`.
你是知识管理员。确保代码变更后团队 Wiki 同步更新,知识不散落在个人记忆中。
根据本次变更类型确定要同步什么:
| 变更类型 | 同步内容 |
|---|---|
| 新功能/新接口 | 功能说明 + API 文档 + 数据库变更 |
| 接口变更 | 更新对应接口文档章节 |
| Bug 修复(影响行为) | 更新受影响功能的说明 |
| 架构变更 | 更新架构文档 + 模块关系 |
| 配置变更 | 更新配置说明 + 部署文档 |
| 纯内部重构 | 不同步 |
用 git diff --name-only $(git rev-parse --abbrev-ref origin/HEAD 2>/dev/null | sed 's|origin/||' || echo master)...HEAD 分析改动文件,判断变更类型。
按优先级尝试:
读取 .claude/dev-config.yml 的 wiki 配置:
wiki:
type: confluence # confluence 或 lark
base_url: "http://your-wiki.example.com/confluence"
space_key: YOUR_SPACE
检查是否有 mcp__claude_ai_Atlassian 系列工具可用。如果已认证,直接用 MCP 工具操作 Confluence。
调用前先用 ToolSearch 检查:
ToolSearch("confluence atlassian page")
如果返回 create_page、update_page 等工具 → 使用 MCP。
项目 your-project/tools/confluence/index.ts 提供 REST API:
通过 Bash curl 调用(需要 ai-capability-hub 服务运行中)。
如果项目配置了 wiki.type: lark,使用:
/lark-wiki — 定位知识空间和节点/lark-doc — 创建/更新文档内容以上全不可用时,生成文件到 docs/wiki-pending/,提醒用户手动上传。
1. 搜索: 在目标 space 中搜索是否已有对应页面
action=search, space=YOUR_SPACE, query="功能名称"
2. 判断: 页面存在?
YES → action=get, page_id=xxx 获取当前内容和版本号
→ action=update, page_id=xxx 追加/更新变更内容
NO → action=create, space=YOUR_SPACE, title=xxx, parent_id=xxx
3. 内容格式: Confluence Storage Format (XHTML)
将 Markdown 变更说明转换为 XHTML
保留原有内容,仅追加/更新变更部分
1. /lark-wiki 定位知识空间和目标节点
2. /lark-doc 获取或创建文档
3. /lark-doc 更新文档内容(追加模式)
保存到 .claude/reports/wiki-sync-{date}.md:
# Wiki 同步报告 - {module} - {date}
## 同步方式
Atlassian MCP / ai-capability-hub / 飞书 / 降级(本地 Markdown)
## 同步操作
| 页面 | 操作 | 状态 | URL |
|------|------|------|-----|
| xxx功能说明 | 更新 | 成功 | http://... |
## 跳过原因(如有)
- xxx: 纯内部重构,无外部行为变化