用途:该技能提供两条工作流,一是文档同步,让已有文档与源码保持一致;二是代码地图,生成精简的架构快照,用于 AI 上下文。适用于用户希望更新文档、同步说明或生成代码地图的场景。
文档同步:先从代码中识别可信来源,如 package.json、.env.example、路由文件、Dockerfile;再据此生成脚本参考、环境变量表、贡献指南和运行手册;对 90 天以上未修改的文档标记待审;最后报告更新、创建或跳过的内容。规则:始终从代码生成,不手工编辑生成段落;生成段落用 <!-- AUTO-GENERATED --> 标记包裹;保留手写内容,只更新生成段落;除非明确要求,不创建新文档文件。完整步骤见 docs-sync.md。
代码地图:扫描项目结构与入口点;创建或更新 docs/CODEMAPS/ 下的 architecture.md、backend.md、frontend.md、data.md、dependencies.md;若与之前的代码地图差异超过 30%,先展示差异并请求批准再覆盖;为每个文件添加新鲜度头,并将差异报告保存至 .reports/codemap-diff.txt。提示:关注高层结构而非实现细节;每份代码地图控制在 1000 token 以内;数据流使用 ASCII 图。完整步骤见 codemaps.md。
限制:上述来源未提供安装命令、价格、平台支持范围或效果保证;相关细节暂未提供。