用途
本技能面向 AG Charts 项目的本地开发工作，覆盖开发服务器搭建与构建监听监控。适用于开始开发工作、检查构建状态或排查开发服务器问题时使用。
主要能力
Astro 开发服务器
- 优先使用端口 4600 上的共享 HTTPS 服务器（当可用时）。
- 使用浏览器自动化工具（claude-in-chrome）时，可能需要在 Chrome 中手动接受一次自签名证书，自动化才能正常工作。操作方式：在浏览器中访问 https://localhost:4600 并接受安全警告。
- 需要跨包和网站的实时重建时，使用 yarn nx dev 启动本地监听。
关键文件位置
- packages/ag-charts-website/src/content/gallery/data.json 负责画廊示例元数据。
- packages/ag-charts-website/src/content/docs-nav/nav.json 负责文档导航结构。
- 文档从 packages/ag-charts-website/src/content/docs/${pageName}/index.mdoc 映射到 /charts/javascript/${pageName}/。
构建监听状态监控
yarn nx dev 监听脚本（external/ag-shared/scripts/watch/watch.js）会在 node_modules/.cache/ag-watch-status.json 维护一个状态文件，用于监控构建状态。可通过检查该文件：
- 在开始操作前确保没有构建正在进行（status != BUILDING）。
- 通过 recentBuilds 数组和 targetHistory 统计监控构建健康度。
- 在文件变更后跟踪构建进度。
关键字段：
- status：STARTING | RUNNING | BUILDING | IDLE | STOPPED
- currentBuild：活动构建详情（仅在 BUILDING 时存在）
- recentBuilds：最近 10 次构建，含状态/时长/错误
- targetHistory：每个目标的成功/失败计数
使用示例：
# Wait for idle before operations
while [ "$(jq -r '.status' node_modules/.cache/ag-watch-status.json 2>/dev/null)" = "BUILDING" ]; do
sleep 2
done
# Start watch if needed
node external/ag-shared/scripts/watch/watch.js charts &
环境 URL
- 生产环境基础 URL：https://www.ag-grid.com/
- 预发布（staging）基础 URL：https://charts-staging.ag-grid.com/
- 注意：预发布站点路径不使用 /charts 路径前缀。
适用场景
- 启动本地开发工作。
- 检查构建状态与构建健康度。
- 排查开发服务器问题。
- 在文件变更后跟踪构建进度。
限制
资料未提供其他限制说明。