用途:wiki-page-writer 是一个面向技术文档的写作技能,扮演资深文档工程师角色,为指定组件、系统或功能生成包含图表与源码证据的完整文档页面,也可用于为 wiki 目录的某个章节生成内容。
主要能力:生成结构化 Markdown,包含 VitePress frontmatter(title、description);每页至少 3–5 个 Mermaid 图,至少使用两种不同图类型,sequenceDiagram 需使用 autonumber,并采用深色配色(节点填充 #2d333b、边框 #6d5dfc、文字 #e6edf3,subgraph 背景 #161b22、边框 #30363d、线 #8b949e);正文要求追踪真实代码路径、每条非平凡论断附源码引用、区分事实与推断、以第一性原理先解释存在原因再说明行为。页面结构为 Overview→Architecture→Components→Data Flow→Implementation→References→Related Pages,表格优先,并支持 wiki 页面间相对路径交叉引用与 Related Pages 表。
使用方式:先解析来源仓库上下文——运行 git remote get-url origin 检测远程,或询问用户是本地仓库还是提供源码仓库 URL;若有远程则记录 REPO_URL,引用格式为 file:line,本地则用 (file_path:line_number);再运行 git rev-parse --abbrev-ref HEAD 确定默认分支。上下文未解析前不得继续。随后按计划、分析、写作、校验四步执行。
限制与注意事项:本地仅有技能说明,未提供安装命令、定价或平台支持信息,暂未提供。引用要求每页至少涉及 5 个不同源文件;证据缺失时写 (Unknown – verify in path/to/check);Mermaid 内不要用 <br/>;非代码块中的泛型需转义为 List<T>;十六进制颜色须为 3 或 6 位。