用途:为 signals.dart 仓库提供系统化的 Jaspr 文档审计与再生成流程,确保 monorepo 中所有公共 API 具备高质量、完整的 /// 文档注释,并附带可用的使用示例。
主要能力:审查 docs/content/packages/ 下生成的参考 Markdown;将文档追溯到 preact_signals、signals_core、signals_flutter、signals_hooks 等包的源码声明;运行文档注释审计脚本;丰富 Dart 源码注释;重新生成文档并预览验证。
使用方式:先查看生成文档,再定位源码,运行 dart /Users/rodydavis/.gemini/antigravity/brain/5f607010-d7ba-40da-b166-4b3c433388c9/scratch/analyze_doc_comments.dart 审计注释;编辑源码时解释响应式行为、惰性计算、记忆化缓存或事件订阅,并给出对比示例,使用 <Info>、<Warning>、<Error>、<Success> 标签而非 ::: 语法;随后执行 dart scripts/generate_docs.dart 生成文档,运行 dart analyze docs 检查,最后在 docs/ 内执行 jaspr build 或 jaspr serve,访问 http://localhost:8080/ 预览。
适用场景:维护 Jaspr 文档站点、补充公共 API 注释、验证文档生成结果。
限制:仅关注 docs/ 目录与 Jaspr 文档站点,完全忽略 website/ 目录(旧版 Astro 配置);具体依赖环境与版本要求暂未提供。