// 同步 AI 工作区文档到 iWiki、从 iWiki 回写本地、做日常增量对齐时使用。只要用户提到“同步到 iWiki”“从 iWiki 拉取”“双向更新”“补齐映射”“重传文档”“个人空间目录对齐”，都应立即使用本 Skill。
管理工作区知识对象的检索与全生命周期操作，路径涉及 `knowledge/`，知识对象包括 issue（需求）、plan（方案 / 计划）、snippet（代码片段）和 troubleshooting（排障经验）。 当用户询问事项进展、最近做了什么、周报 / 日报 / 总结素材，或者问题依赖历史结论、过往决策时，应优先使用本 skill。 当用户要求将结论沉淀到知识对象体系，或者要求检索、创建、修改、归档、迁移知识对象时，应使用本 skill 执行相关操作。 外部资料调研、纯代码实现 & 调试 & 测试等无需落地知识对象的行为不属于本 skill 场景。
执行代码审查、PR review、复查、处理未解决 review threads、发 review 评论、request changes 或 approve 前必须使用。适用于检查 GitHub PR diff、本地变更、相关源码、测试覆盖、项目规范和既有评论，并输出对话草稿，或在明确授权后发布 inline / conversation review 评论。
结构化编写、重构、润色和验收 Markdown / MDC 文档。 只要用户要创建、编辑、润色、改写、评审或整理任何 `.md` / `.mdc` 文件， 或需要整理规则文档、普通说明文档、PR review 评论、GitHub 评论、零散草稿，就应使用这个 skill。
通过 repos.json 注册和管理工作区中的项目。当用户想要接入项目、移除项目、询问项目设置规范，或消息中提到已注册项目名并需要定位 local_path 时使用。
处理通用代码风格与实现约束。用于源码读取、编辑、评审和规则迁移。
准备和修复 Go、Node.js、Python 本地开发环境。用于版本切换、工具链缺失、依赖环境异常、虚拟环境问题，以及编译、测试、检查命令中的环境类失败。
| name | iwiki-sync |
| title | iwiki-sync — AI 工作区与 iWiki 双向同步 |
| description | 同步 AI 工作区文档到 iWiki、从 iWiki 回写本地、做日常增量对齐时使用。只要用户提到“同步到 iWiki”“从 iWiki 拉取”“双向更新”“补齐映射”“重传文档”“个人空间目录对齐”，都应立即使用本 Skill。 |
目标：让 knowledge/ 与 iWiki 个人空间保持可持续、可回溯、可增量的双向同步。
MCP Server：user-iWiki
knowledge/<project>/ 开始，不直接同步整个仓库。INDEX.md 默认不同步（仅同步 issue 实体文档）。.iwiki-sync.json。mcps/user-iWiki/tools/*.json）。位置：工作区根目录 .iwiki-sync.json（应被 .gitignore 忽略）。
建议结构：
{
"space_id": 136740934,
"homepage_id": 135057649,
"root_title": "AI 工作区",
"sync_policy": {
"index_sync": false,
"conflict_mode": "manual",
"deletion_mode": "tombstone"
},
"mappings": {
"knowledge/bkmonitor/issues/2026-03-03-apm-shared-datasource/README.md": {
"docid": 4018554751,
"type": "MD",
"iwiki_title": "需求",
"last_local_updated": "2026-03-03",
"last_sync_at": "2026-03-08T12:30:00Z",
"status": "active"
}
}
}
字段说明：
space_id / homepage_id: iWiki 定位信息。root_title: iWiki 顶层目录名，固定为 AI 工作区。sync_policy.conflict_mode: manual | local_wins | remote_wins。sync_policy.deletion_mode: 推荐 tombstone（标记删除，不做远端删除）。mappings[*].status: active | tombstone。目录骨架固定为：AI 工作区 → <project> → <category>。
命名规则：
{date}-{frontmatter.title}。README.md → 需求。PLAN.md → 实施方案。PROGRESS.md → 进展。INDEX.md：默认不同步。示例：
knowledge/bkmonitor/issues/2026-03-03-apm-shared-datasource/2026-03-03-APM 支持跨应用共享数据源.iwiki-sync.json，确认 space_id、homepage_id 与 root_title。INDEX.md。createDocument）。saveDocument）。.iwiki-sync.json。新增操作规范：
contenttype="FOLDER"，body 传 " "。contenttype="MD"，body 传完整 Markdown。更新操作规范：
saveDocument(docid, title, body)。body。.iwiki-sync.json 取目标 docid。getDocument 获取远端正文。last_sync_at 与状态字段。适用场景：
当“本地 updated 晚于 last_sync_at”且“远端也发生变更”时，判定为冲突。
manual（默认）：停止自动覆盖，提示用户选择来源。local_wins：本地覆盖远端。remote_wins：远端覆盖本地。由于无 deleteDocument API，不执行物理删除：
tombstone。[已归档] <title>，用于人工清理。createDocument 与 saveDocument 在当前环境下都应传非空 body。body: " "。deleteDocument，删除需走 tombstone/归档策略。每次同步后执行：
mappings 活跃条目数。同步任务结束后按以下结构汇报：
.iwiki-sync.json 是否已更新