Agent Skills 文档新手友好度优化

[JusterZhu]

问题描述

当前 Agent Skills 页面内容对第一次接触 GeneralUpdate 的开发者不够友好：

• 术语（IPC、Bowl、manifest.json、Bootstrap）直接使用，无解释
• 代码示例直接从完整版开始，缺少渐进引导
• 更新策略名词（OSS、CVP、静默、差分）未附带通俗解释
• 缺少"为什么需要双进程架构"等前置概念说明

修改内容

overview.md

• 修复仓库引用：tmpgeneralupdate-skill-codegen → generalupdate-skill-codegen（独立仓库）
• 新增"什么是 Agent Skill？"概念解释章节
• 新增多 AI 编程工具集成指南（Claude Code、GitHub Copilot、Cursor、Windsurf、Cline、DeepSeek 等）
• 新增 3 种安装方式（直接克隆、git submodule、按需复制）
• 删除冗余的 zh-Hans i18n 文件（zh-Hans 是 Docusaurus 默认语言）

generalupdate-init.md

• 开头新增"为什么需要双进程？"通俗解释（附流程图）
• 安装步骤从 3 行最简配置开始，再展开完整配置
• 6 个必填字段增加"为什么需要"列
• 术语（IPC、manifest.json）内联解释
• 代码分段：最简版 → 事件监听版 → 完整配置
• 简化"4 大更新场景"的表述
• 用"新手常见错误"替代原来的"反模式"（表述更友好）
• 删除冗余的"API 兼容性说明"段落（已在 overview 中覆盖）

generalupdate-ui.md

• 开头新增 Client/Upgrade 角色对比图
• 状态机从 11 种状态简化为 4 种关键状态
• 新增"你属于哪种情况"快速定位表
• 精简框架模板表格，突出选择依据
• 核心桥接逻辑简化为"5 个数字映射到 UI"的表述
• 新增控制台进度条示例（无 GUI 也能用）
• 删除冗余的"集成验证清单"（已在 overview 中覆盖）

generalupdate-strategy.md

• 开头新增"策略的本质是 3 个问题"的通俗解释
• 用"快速选择表"替代原决策树（更直观）
• 每种策略带使用场景 + 流程图 + 优缺点
• 新增"如果你不确定选哪个"的兜底推荐
• 用"需要留意的事情"替代原"已知问题"表格

PR

• Branch: fix/skill-docs-newbie-rewrite
• PR: https://github.com/GeneralLibrary/GeneralUpdate-Samples/pull/new/fix/skill-docs-newbie-rewrite