返回 Skill 列表
extension
分类: 开发与工程无需 API Key

docs-auto-sync

每当代码发生变化(添加/编辑/重构)时自动更新仓库文档。在修改源代码、公共API/合同、渲染/交互/数据/计算逻辑、诊断或构建/发布/CI流程时使用,以确保文档保持一致,无需额外询问。

person作者: jakexiaohubgithub

Docs Auto Sync

Overview

Keep documentation in sync with code changes by updating the required docs in the same change set. Default to automatic updates; only ask if a required detail is missing.

Workflow

  1. Classify the change scope.
  • Identify layers touched (core/rendering/interaction/data/compute/api/diagnostics/ci/packaging).
  • Note any contract, lifecycle, or budget changes (see AGENTS.md).
  1. Choose docs to update.
  • Use references/doc-impact-matrix.md to map change types to docs.
  • If multiple layers are touched, add a short design note per AGENTS.md.
  • For contract changes, add version notes and a migration note.
  1. Update docs automatically.
  • Apply edits in the same change set.
  • Add a rationale to any new doc: why it belongs in chart-engine and not quant-lab.
  • Keep cross-links and references consistent.
  1. Validate before final response.
  • Ensure doc DoD: cross-links updated, invariants/SLOs referenced, version notes added.
  • Summarize which docs were updated and why.

Resources

  • references/doc-impact-matrix.md - change types and required docs.