AgentSkillsCN

docs-auto-sync

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

SKILL.md
--- frontmatter
name: docs-auto-sync
description: Automatically update repository documentation whenever code changes (add/edit/refactor) occur. Use when modifying source code, public APIs/contracts, rendering/interaction/data/compute logic, diagnostics, or build/release/CI flows so docs stay consistent without asking.

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.