project-wiki
组织和维护 Vibe Coding 项目的 wiki 文档体系。当用户要求初始化/重构 wiki 结构、进入新项目且 wiki/ 不存在、需要诊断和修复文档腐化、或需要管理 specs/refs/reviews 子目录的生命周期时触发。
npx skills add GeminiLight/MindOS --skill project-wiki --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Project Wiki Skill 为 Vibe Coding 项目（人类描述意图，Agent 写代码）生成和维护结构化 wiki。wiki 是 Agent 的输入物料，直接决定输出质量。 --- ## 执行流程 ### 初始化（wiki/ 不存在或为空） 1. **扫描** `wiki/` 目录，列出已有文件 2. **对照必要文件清单**（见下方"文件体系"），识别缺失项 3. **与用户确认**将要创建的文件列表 4. **生成骨架**：从本 Skill 的 `assets/` 目录读取对应模板，填入用户上下文（不确定的部分留 `<!-- TODO: ... -->` 占位） 5. **更新导航**：如已有 `01-project-roadmap.md`，追加新阶段索引行 6. **标记新鲜度**：每个生成的文件头部加 `<!-- Last verified: YYYY-MM-DD | Current stage: X -->` 7. **注入维护规则**：将下方"日常维护规则"章节的内容追加到项目 `CLAUDE.md`（已有则合并差异，不替换整个文件）。这一步不能跳过——wiki 的日常同步依赖这些规则写入 CLAUDE.md ### 重构 / 更新（wiki/ 已有文件） 1. **扫描** `wiki/` 下所有文件和子目录，检查编号方案（紧凑 or 展开）、新鲜度标记 2. **诊断**： - 缺编号前缀？信息重叠？已完结 stage 未归档？内容与代码不一致？ - **膨胀检测**：stage 文件超 300 行、其他文件超 500 行 → 建议拆分 - **散落文件**：wiki 根目录中不属于任何编号区段的文件（如 `ui-audit-*.md`）→ 建议归入合适的子目录（`reviews/`）或运维区段（`8x`） - **命名一致性**：`specs/` 下混有 `task-spec-*` 和 `spec-*` → 不强制迁移，但新建一律用 `spec-*`；spec 散落在 wiki 根目录 → 建议迁入 `specs/` - **自定义子目录**：识别 `plugins/`、`images/` 等项目特有目录，标记为已知自定义目录，不报为异常 3. **生成改动清单**（重命名 / 合并 / 拆分 / 归档 / 迁移 / 更新内容），与用户确认 4. **执行改动** 5. **验证一致性**：文件间引用链接有效、roadmap 索引与实际文件对应 6. **检查维护规则**：确认项目 `CLAUDE.md` 中已有 wiki 维护规则，缺失则追加（不替换整个文件） --- ## 文件体系 ### 编号体系 编号按**"战略 → 架构 → 规范 → 阶段 → 运维 → 日志"**分层。根据项目规模选择紧凑或展开方案： **
- 执行流程
- 初始化（wiki/ 不存在或为空）
- 重构 / 更新（wiki/ 已有文件）
- 文件体系
- 编号体系
- 核心模型：Why / What / How / Look × 全局 / 阶段
- 规划层级
- 必要文件（第一梯队）
- 按需文件（第二梯队）
- Stage 文件生命周期
- 子目录管理
- 渐进式披露
- 关联管理
- Agent 阅读顺序（渐进式）
What does the project-wiki skill do?
组织和维护 Vibe Coding 项目的 wiki 文档体系。当用户要求初始化/重构 wiki 结构、进入新项目且 wiki/ 不存在、需要诊断和修复文档腐化、或需要管理 specs/refs/reviews 子目录的生命周期时触发。
How do I install it?
Run `npx skills add GeminiLight/MindOS --skill project-wiki --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From GeminiLight/MindOS, a repository with 657 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.