AgentSkillsCN

docs-and-handover-guardrails

在升级过程中，确保操作员与交接文档与行为变化保持一致。当升级导致认证流程、Runner运行逻辑、API行为、权限设置、Schema假设，或项目指南中记载的UX流程发生改变时使用。

SKILL.md
--- frontmatter
name: docs-and-handover-guardrails
description: Keep operator and handover documentation aligned with behavior changes. Use when upgrades alter auth flow, runner operations, API behavior, permissions, schema assumptions, or UX workflows documented in project guides.

Docs And Handover Guardrails

Update requirements

  • •Update README.md when setup/run/operational behavior changes.
  • •Update AGENTS.md when architecture truth, security invariants, or validation checklist changes.
  • •Update .agents/tasks/todo.md with checklist progress and a final review note.
  • •In this repository, when updating README.md, limit edits to:
    • •Current Development Status
    • •usage commands (run/build/test/serve style command snippets)
    • •Do not expand README into full handover-level detail.

Content quality rules

  • •Write all documentation in English.
  • •Document only confirmed behavior from code and checks.
  • •Keep wording concrete and testable.
  • •Remove stale statements rather than layering contradictory notes.

Completion rules

  • •Do not claim complete until docs match implemented behavior.
  • •Include verification evidence or explicit limitation notes when behavior is not fully verified.