nexus-modify-wiki
starsforks
How to install nexus-modify-wiki?
niki914/agentic-nexus/nexus-modify-wiki
$npx -y skills add niki914/agentic-nexus --skill nexus-modify-wikiUse when updating or adding nexus-lookup wiki pages, especially after code changes, doc review, or when fixing stale paths, status drift, and overgrown reference content.
SKILL.md
| 1 | # Nexus Modify Wiki |
| 2 | |
| 3 | ## Overview |
| 4 | |
| 5 | 这个 skill 用于修改 `wiki/` 下的 `nexus-lookup` 仓库 wiki 文档，目标是让文档持续反映**当前源码事实**，而不是继续累积过时设计、失效引用和写作者视角的噪音。 |
| 6 | |
| 7 | 它不是通用文档美化器。它只服务于 `wiki/` 这套仓库内 wiki。 |
| 8 | |
| 9 | ## When to Use |
| 10 | |
| 11 | 在以下场景使用： |
| 12 | |
| 13 | - 新增或重写 `wiki/` 下的任意 wiki 文档 |
| 14 | - 代码已变化，需要同步 wiki 里的路径、状态或术语 |
| 15 | - 审稿后需要统一清理失效引用、过期设计痕迹、重复膨胀内容 |
| 16 | - 发现 wiki 把“半落地”写成“已落地”，或把 PRD 写成既成事实 |
| 17 | - 发现路径写成 `../`、`file:///`、`.../`、孤立文件名，导致读者无法按项目路径继续查源码 |
| 18 | |
| 19 | 不要用于： |
| 20 | |
| 21 | - 回答单个源码问题但不需要修改 wiki |
| 22 | - 编写 PRD、任务计划、方案设计文档 |
| 23 | - 维护 `docs/.asc_task/` 下的产物 |
| 24 | |
| 25 | ## Required Prep |
| 26 | |
| 27 | - **REQUIRED SKILL:** 先加载 `Prompt Engineering` |
| 28 | - **REQUIRED SKILL:** 再加载 `nexus-lookup` |
| 29 | - 必须先读 `wiki/index.md` |
| 30 | - 只读当前目标文档及其对应源码入口，不顺手扩写无关页面 |
| 31 | |
| 32 | ## Core Rules |
| 33 | |
| 34 | ### 1. 源码优先 |
| 35 | |
| 36 | - 当前实现、调用顺序、能力状态、目录入口，一律以源码为准 |
| 37 | - 禁止读取、引用、登记 `docs/.asc_task/` |
| 38 | - PRD 只能描述目标态或提案，不能作为“已实现”的证据 |
| 39 | |
| 40 | ### 2. 路径统一 |
| 41 | |
| 42 | - 路径统一使用**项目根相对路径** |
| 43 | - 推荐写法：`app/src/main/java/com/niki914/nexus/agentic/chat/LLMController.kt` |
| 44 | - 禁止 `../`、`../../../../../`、`file:///`、绝对路径、`.../` 省略路径 |
| 45 | - 除非同一小节已经先给出公共前缀，否则不要只写 `LLMController.kt` |
| 46 | |
| 47 | ### 3. 引用必须验真 |
| 48 | |
| 49 | - 每次写入一个文档、源码或目录路径前，先确认它真实存在 |
| 50 | - 如果目标已不存在，直接删除引用，不要保留“历史上有过”的痕迹 |
| 51 | - 不要凭目录命名习惯臆断路径，例如把 `agentic/app/ui/` 写成 `ui/feat/` |
| 52 | |
| 53 | ### 4. 状态必须拆细 |
| 54 | |
| 55 | - 禁止把半落地能力粗暴写成“已落地” |
| 56 | - 要拆成“哪部分已落地，哪部分未落地” |
| 57 | - 如果某能力只有配置解析、模型结构或 UI 骨架存在，而执行器、联动逻辑或真实数据源未落地，必须明确写出缺口 |
| 58 | |
| 59 | ### 5. 删除作者视角噪音 |
| 60 | |
| 61 | 以下内容默认不应该出现在 wiki 正文： |
| 62 | |
| 63 | - `## 目的` |
| 64 | - `## 写作约束` |
| 65 | - `## 全局写作约束` |
| 66 | - `## 文档维护原则` |
| 67 | - `## 建议信息来源` |
| 68 | - “后续应填充的信息”“建议引用的源码位置”这类写给文档作者的话 |
| 69 | |
| 70 | wiki 面向读者，不面向下一位写文档的人。 |
| 71 | |
| 72 | ### 6. 按分区写内容 |
| 73 | |
| 74 | - `overview/`：项目总览、当前状态、能力边界 |
| 75 | - `architecture/`：跨模块机制、调用链、状态流转、配置流转 |
| 76 | - `domains/`：宿主专项心智、关键 Hook、调试入口 |
| 77 | - `reference/`：索引、注册表、路径地图；不承载行为分析 |
| 78 | |
| 79 | 不要把一个分区写成另一个分区。 |
| 80 | |
| 81 | ### 7. 控制重复膨胀 |
| 82 | |
| 83 | - 类似 `source-map.md` 的索引页，二级标题下先声明公共前缀，再列子路径 |
| 84 | - 允许写法： |
| 85 | - `## app/src/main/java/com/niki914/nexus/agentic/chat/` |
| 86 | - `- LLMController.kt` |
| 87 | - `- agentic/ToolManager.kt` |
| 88 | - 不要在同一节里重复十几次相同前缀 |
| 89 | |
| 90 | ### 8. 术语统一 |
| 91 | |
| 92 | - 同一个概念只保留一个主名称 |
| 93 | - 如果历史上有别名，首次出现时说明一次，后续统一使用主名称 |
| 94 | - 相邻文档中的 Hook 名、模式名、状态名必须对齐 |
| 95 | |
| 96 | ## Editing Workflow |
| 97 | |
| 98 | 1. 读 `wiki/index.md`，确认应该改哪一篇，不扩散 |
| 99 | 2. 读目标文档，圈出以下问题： |
| 100 | - 路径不规范 |
| 101 | - 引用失效 |
| 102 | - 使用了 `docs/.asc_task/` |
| 103 | - 作者视角噪音 |
| 104 | - 状态写粗 |
| 105 | - 同前缀重复膨胀 |
| 106 | 3. 读支撑这些断言的真实源码路径 |
| 107 | 4. 删除失效信息，不保留“历史包袱” |
| 108 | 5. 用项目根相对路径、统一术语、细粒度状态重写正文 |
| 109 | 6. 如果改动会影响相邻索引页或状态页，同步检查： |
| 110 | - `wiki/index.md` |
| 111 | - `wiki/overview/current-status.md` |
| 112 | - `wiki/reference/source-map.md` |
| 113 | - `wiki/reference/task-docs-registry.md` |
| 114 | 7. 交付前做一次全文自检 |
| 115 | |
| 116 | ## Rewrite Checklist |
| 117 | |
| 118 | - 已读 `wiki/index.md` |
| 119 | - 已确认目标文档所属分区和职责边界 |
| 120 | - 每个“当前/已落地/实际/会”断言都能回指源码 |
| 121 | - 不含 `docs/.asc_task/` |
| 122 | - 不含 `../`、`file:///`、绝对路径、`.../` |
| 123 | - 不含无意义的作者说明章节 |
| 124 | - 不含不存在的文件或目录引用 |
| 125 | - 半落地能力已拆成“已实现部分 / 未实现部分” |
| 126 | - 术语在相邻文档中保持一致 |
| 127 | - 索引页已收敛重复前缀 |
| 128 | |
| 129 | ## Good vs Bad |
| 130 | |
| 131 | ### 路径 |
| 132 | |
| 133 | Bad: |
| 134 | |
| 135 | ```md |
| 136 | - [ASC_may_25.md](../../../../../ASC_may_25.md) |
| 137 | - [BreenoChatHook.kt](file:///Users/xxx/.../BreenoChatHook.kt) |
| 138 | - app/src/main/java/.../Entrance.kt |
| 139 | ``` |
| 140 | |
| 141 | Good: |
| 142 | |
| 143 | ```md |
| 144 | - `ASC_may_25.md` |
| 145 | - `app/src/main/java/com/niki914/nexus/agentic/mod/feat/oppo/BreenoChatHook.kt` |
| 146 | - `app/src/main/java/a0/a0/a0/a0/a0/a0/Entrance.kt` |
| 147 | ``` |
| 148 | |
| 149 | ### 状态 |
| 150 | |
| 151 | Bad: |
| 152 | |
| 153 | ```md |
| 154 | - 已落地：LLM Controller v2 |
| 155 | ``` |
| 156 | |
| 157 | Good: |
| 158 | |
| 159 | ```md |
| 160 | - 已落地：`LLMController`、`PromptComposer`、`ToolManager`、HTTP MCP 注册 |
| 161 | - 未落地：Local Tool executor |
| 162 | ``` |
| 163 | |
| 164 | ### 失效引用 |
| 165 | |
| 166 | Bad: |
| 167 | |
| 168 | ```md |
| 169 | - `docs/.asc_task/llm_controller_v2/tech_design.md` |
| 170 | - `app/src/main/java/com/niki914/nexus/agentic/chat/v2/LLMController.kt` |
| 171 | ``` |
| 172 | |
| 173 | Good: |
| 174 | |
| 175 | ```md |
| 176 | - `app/src/main/java/com/niki914/nexus/agentic/chat/LLMController.kt` |
| 177 | - 删除所有 `.asc_task` 相关登记 |
| 178 | ``` |
| 179 | |
| 180 | ### 控制重复 |
| 181 | |
| 182 | Bad: |
| 183 | |
| 184 | ```md |
| 185 | - `app/src/main/java/com/niki914/nexus/agentic/chat/LLMController.kt` |
| 186 | - `app/src/main/java/com/niki914/nexus/agentic/chat/LlmStreamEvent.kt` |
| 187 | - `app/src/main/java/com/niki914/nexus/agentic/chat/agentic/ToolManager.kt` |
| 188 | ``` |
| 189 | |
| 190 | Good: |
| 191 | |
| 192 | ```md |
| 193 | ## app/src/main/java/com/niki914/nexus/agentic/chat/ |
| 194 | |
| 195 | - `LLMController.kt` |
| 196 | - `LlmStreamEvent.kt` |
| 197 | - `agentic/ToolManager.kt` |
| 198 | ``` |
| 199 | |
| 200 | ## Common Mistakes |
| 201 | |
| 202 | - 把项目根相对路径写成文档相对链接，导致路径不可用 |
| 203 | - 把设计稿、任务产物、缓存目录当成实现依据 |
| 204 | - 看到一个目录名就凭感觉补完整条路径，没有核实文件是否存在 |
| 205 | - 用“已落地”掩盖半落地事实 |
| 206 | - 在 wiki 里保留写作者说明，污染读者视角 |
| 207 | - 在索引页无脑重复完整前缀，导致内容膨胀 |
| 208 | |
| 209 | ## Output |
| 210 | |
| 211 | 完成修改后，给出简短报告： |
| 212 | |
| 213 | ```text |
| 214 | 修改报告 |
| 215 | |
| 216 | 已改文件: |
| 217 | - path/to/file.md — 做了什么 |
| 218 | |
| 219 | 已删除的失效引用: |
| 220 | - path/to/missing-doc.md |
| 221 | |
| 222 | 已统一的术语或路径: |
| 223 | - old -> new |
| 224 | |
| 225 | 剩余待核实问题: |
| 226 | - 哪些地方还需要进一步看源码 |
| 227 | ``` |
People who liked this also viewed
6 picksType
- find-skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skSkillsJul 2026
- grill-meA relentless interview to sharpen a plan or design.SkillsJul 2026
- vercel-react-best-practicesVercel's official collection of agent skillsSkillsJul 2026
- improve-codebase-architectureScan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.SkillsJul 2026
- setup-matt-pocock-skillsConfigure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.SkillsJul 2026
- triageMove issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs.SkillsJul 2026
