AgentSkillsCN

handoff

完成交接准备：更新HANDOFF/REPO_MAP，轮转日志，如有需要则更新.gitignore，并创建一次安全的交接Git Commit。

SKILL.md
--- frontmatter
name: handoff
description: Prepare handoff: update HANDOFF/REPO_MAP, rotate logs, update .gitignore if needed, and create a safe handoff git commit.

When invoked, do this in order.

A) Documentation and state (must do)

  1. •

    Update HANDOFF.md:

    • •Fill/refresh every section.
    • •Include concrete evidence: file paths and (if a commit is created) the commit hash.
  2. •

    Update REPO_MAP.md only if needed:

    • •new important file/dir/entrypoint created
    • •important file moved/renamed
    • •canonical commands/entrypoints changed
    • •focus area ("hot paths") changed
  3. •

    Ensure .gitignore stays strict for artifacts and secrets.

B) Log rotation (must do)

  1. •Determine next log filename:
    • •agent_logs/YYYY-MM-DD_agentNN.md, where NN is 00, 01, 02, ... chosen as the next unused number for today.
  2. •Move agent_logs/current.md -> that filename.
  3. •Append a one-line entry to agent_logs/INDEX.md:
    • •- YYYY-MM-DD_agentNN.md — <short summary> (optional: commit <hash>)
  4. •Create a fresh agent_logs/current.md.

C) Safe handoff commit (must do, unless safety checks fail) Before committing, always show:

  • •git status
  • •git diff --stat

Never commit artifacts or secrets (see .gitignore).

Commit message:

  • •agentNN: handoff(<area>): <short description>
  • •Derive agentNN from agent_logs/current.md (field id:). If missing, stop and ask the human.
  • •Choose <area> from: workflow, docs, engine, viewer, runner, schemas, misc.