Agent skill

Handover

by k1ein-chen in k1ein-chen/Harness-Starter

将当前会话中的技术决策、运维流程或阶段性研发进展,归档为标准工程文档(ADR / SOP / Handover),并自动更新模块内的 README 归档索引。

MITAuto-check passedDevelopment

Install Handover

skills CLI
$ npx skills add k1ein-chen/Harness-Starter --skill handover -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install k1ein-chen/Harness-Starter handover --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/k1ein-chen/Harness-Starter.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/handover .claude/skills/handover && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
handover
GitHub stars
119
Token cost
~752 tokens
SKILL.md length
164 words
Files
4 (incl. references)
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

将当前会话中的技术决策、运维流程或阶段性研发进展,归档为标准工程文档(ADR / SOP / Handover),并自动更新模块内的 README 归档索引。

  • Works in 4 steps: 物理事实核验(杜绝文件幻觉) → 规范模板要素(路由地图 + 正向资产交互) → 按需查阅模板:使用 view_file 查阅上述对应的单个模板(例如确定写… → …
  • Tasks that involve Architecture decision records
  • SKILL.md covers 一、 框架定位:HDD (Handoff-Driven…, 二、 快速确定文档类型 (ADR / SOP /…, 三、 两步正向直出工作流 (SOP) and 四、 写作风格与接班导引
  • Calls git

What it does

Handover is an agent skill from k1ein-chen/Harness-Starter. 将当前会话中的技术决策、运维流程或阶段性研发进展,归档为标准工程文档(ADR / SOP / Handover),并自动更新模块内的 README 归档索引。

Its SKILL.md is about 750 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/adr_template.md`, `references/handover_template.md` and `references/sop_template.md`).

It sits in Development, covering Architecture decision records, Operations and SOPs and Technical documentation. It works with Git. The repository describes itself as: 一套成熟完善的开箱即用的 Claude Code Harness Engineering 模板。三层自动化(安全/感知/审查),集成 LSP、OpenSpec SDD 工作流和 AI 一键初始化。新项目和已有项目均可使用。 The licence is MIT.

When your agent uses it

  • Tasks that involve Architecture decision records
  • Tasks that involve Operations and SOPs
  • Tasks that involve Technical documentation

Example prompts

  • “/handover”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. 物理事实核验(杜绝文件幻觉)
  2. 规范模板要素(路由地图 + 正向资产交互)
  3. 按需查阅模板:使用 view_file 查阅上述对应的单个模板(例如确定写 ADR 则仅阅读 references/adr_template.md,无需阅读其他模板)。
  4. 生成命名并落盘

What it can do on your machine

Read from SKILL.md and the folder at commit c211c43. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Handover loads about 752 tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 22 tokens; SKILL.md has 164 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~22
When it runs · the whole SKILL.md, loaded when a task matches
~752
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from k1ein-chen/Harness-Starter at commit c211c43, republished under its MIT licence (© k1ein-chen). 164 words, ~752 tokens.

Download SKILL.mdSave it as .claude/skills/handover/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
handover
description
将当前会话中的技术决策、运维流程或阶段性研发进展,归档为标准工程文档(ADR / SOP / Handover),并自动更新模块内的 README 归档索引。
argument-hint
[adr | sop | handover] [核心主题与简要说明]

工程交接与架构归档指南 (Engineering Handover & ADR & SOP)

你好!当你在一次开发会话中完成了关键攻坚、做了重要技术选型、或者跑通了一套复杂的运维跑批流程时,把这些成果及时沉淀下来,是保证后续其他同学或新会话 Agent 能无缝接力、不踩重复坑的最稳妥方式。


一、 框架定位:HDD (Handoff-Driven Development)

本 Skill 属于 HDD 体系的 Handoffs 层:

  • 职责核心:专职解决跨会话、跨模型周期的“状态机转移、物理事实防幻觉与真理知识沉淀”;
  • 非目标 (Non-Goals):本 Skill 不做日常编码流程的裁判(不强制 TDD、不限制具体的开发范式),只负责在阶段性收口或交接时打出高保真断点;
  • 抗模型迭代衰减:无论未来底层大模型推理能力如何升级,AI 均无法凭空预知你的私有业务决策、客观时序冲突与当前跑批状态。结构化的 Handoffs 是系统长期演进中抵御遗忘的最坚固防线。

本 Skill 采用控制逻辑与参考模板分离的轻量设计:主文件负责流程导航,骨架模板按需单点查阅。


二、 快速确定文档类型 (ADR / SOP / Handover)

根据当前会话的核心成果,挑选最契合的一个类型,并查阅对应的模板文件:

文档类型适用场景状态标签 (Status 推荐)对应参考模板核心目标
ADR (架构决策)技术选型、航道拆分/合并、引入新库、重大权衡或决定“暂不改动”架构决策 (ADR)、探讨/提案 (RFC)references/adr_template.md讲清为什么选 A 不选 B,避免未来盲目推倒重来
SOP (运维手册)定时任务、周末跑批、凭据更新、自动化巡检、故障排查生产固化 (Active)、维护中 (Draft)references/sop_template.md给出复制即用的命令与自愈预案,保证无人值守稳定运行
Handover (研发交接)每日收工、攻坚战役完成、门禁规则升级、代码重构收口生产基准 (Current)、版本归档 (Archived)references/handover_template.md交代今天改了哪、跑了什么单测、明天接班第一步敲什么

提示:如果用户未指定类型,且当前会话主要是修了 Bug、优化了业务代码并跑通了验证,请默认采用 Handover 类型。


三、 两步正向直出工作流 (SOP)

当被触发执行归档交接时,请直接执行以下两个步骤,杜绝无意义的中间态工具调用:

第一步:查阅对应模板并落盘文档
  1. 物理事实核验(杜绝文件幻觉):
    • 绝对不要凭多轮对话的模糊记忆盲猜改动文件。在列出“改动清单”和“核心代码资产”之前,先锚定真实的物理事实:
      • 若工作区存在 Git:运行 git status -s 查看真实改动;
      • 若工作区非 Git:核实本会话实际通过 write_to_file 或 replace_file_content 动过的文件,或在终端检查目标模块最近修改的文件时间戳;
    • 真实存在性保障:文档中引用的每一个文件路径与链接,必须在磁盘中真实存在,严禁凭空构造不存在的辅助脚本或类库。
  2. 规范模板要素(路由地图 + 正向资产交互):
    • 必须在顶部包含清晰扁平的 路由式摘要(注明当前状态、关键决策、改动范围、接班即刻动作及重点必读章节);
    • 涉及大型数据底册或日志时,在涉及文件清单中正向注明抽样或 grep 建议,杜绝大篇幅罗列禁区的“负向激发反模式(粉色大象)”。
  3. 按需查阅模板:使用 view_file 查阅上述对应的单个模板(例如确定写 ADR 则仅阅读 references/adr_template.md,无需阅读其他模板)。
  4. 生成命名并落盘:
    • 文件名规范:YYYY-MM-DD_<topic_slug>.md(如 2026-09-18_quality_gates_upgrade.md);
    • 写入对应业务模块下的 docs/handovers/ 目录;
    • 使用 write_to_file 工具直接写入目标目录。
第二步:更新归档索引表 (README.md)
  1. 使用 view_file 查阅该目录下的 README.md。
  2. 时间序归档表追加:在 ## 归档索引 表格的最上方(紧随表头后第一行),插入本次新文档的归档行:
    markdown
    | YYYY-MM-DD | [YYYY-MM-DD 文档标题](./文档文件名.md) | 核心主题摘要(2~3 句话清晰提炼) | 状态标签 |
  3. 主题与分类导航同步:若该 README 维护了按主题分类导航(如 ### 架构决策 (ADR)、### 运维指南 (SOP) 等板块),同步在该分类列表下追加对应的超链接与一句话定位,实现时间序与主题序双维检索。
  4. 使用 replace_file_content 将新增内容合并入 README.md,保持索引看板永远最新。

四、 写作风格与接班导引

  • 老程序员带新人的口吻:语言平实、温和、逻辑严谨,多解释“为什么要这样做”,避免使用生硬或压迫性字眼;
  • 信息高保真度:严禁含糊其辞,关键代码使用可点击的 Markdown 文件链接,运维操作给出完整的带参命令行,验证给出明确的测试断言与耗时;
  • 新 Agent 快速冷启动:新接手的 Agent 进入项目时,只需查阅 docs/handovers/README.md 顶部的最新交接文档,通过顶部的 路由式摘要 建立大局观,再按指引跳转到关键章节,即可在 10 秒内理解当前系统状态并执行下一步操作。

© k1ein-chen, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in .agents/skills/handover of k1ein-chen/Harness-Starter.

  • SKILL.md
  • references/adr_template.md
  • references/handover_template.md
  • references/sop_template.md

Open the folder on GitHubat commit c211c43

Compare with similar skills

Handover next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Handover compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Handover this skillk1ein-chen/Harness-Starter119—~752Automated safety check: PassMIT
Research Initbrycewang-stanford/Auto-Empirical-Research-Skills4.5k—~839Automated safety check: PassCustom licence
Agentsop Aideragentsope/SkillAlchemy466—~3.5kAutomated safety check: PassMIT
Doc SyncJetBrains/ideavim10k2 repos~2.6kAutomated safety check: PassMIT
Mermaid Diagramsjjmartres/opencode1336 repos~1.9kAutomated safety check: PassMIT
Acquire Codebase Knowledgegithub/awesome-copilot40k1 repos~2.3kAutomated safety check: PassMIT

Similar skills

  • Research Init

    brycewang-stanford/Auto-Empirical-Research-Skills

    Scaffold a new research project with full reproducibility infrastructure in R and/or Python.

    4.5k GitHub stars~839 tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • Agentsop Aider

    agentsope/SkillAlchemy

    SOP for terminal-based, git-native AI pair programming with Aider (git work-tree + tree-sitter repo-map + edit-format + human-in-loop REPL).

    466 GitHub stars~3.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Doc Sync

    JetBrains/ideavim

    Official

    Keeps IdeaVim documentation in sync with code changes. An agent skill from JetBrains/ideavim.

    10k GitHub starsUsed in 2 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Mermaid Diagrams

    jjmartres/opencode

    Helps an agent pick the right Mermaid diagram type and write the syntax for class, sequence, flow, ER, C4, state and other software diagrams.

    133 GitHub starsUsed in 6 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Acquire Codebase Knowledge

    github/awesome-copilot

    Official

    Maps an unfamiliar codebase into seven evidence-backed documents in docs/codebase/, using a scan script and templates, for onboarding or architecture write-ups.

    40k GitHub starsUsed in 1 repo~2.3k tokens
    DevelopmentAuto-check passed
  • Adds, updates, moves and removes pages on the NeMo Curator Fern documentation site, keeping navigation entries, links and redirects in step.

    1.8k GitHub stars~4.3k tokensUpdated today
    DevelopmentAuto-check passed

More from k1ein-chen/Harness-Starter

  • Harness Init

    k1ein-chen/Harness-Starter

    Initialize this project with the Harness Engineering starter template.

    119 GitHub stars~995 tokensUpdated 15 days ago
    Auto-check: notes
  • Harness Start

    k1ein-chen/Harness-Starter

    Entry point for new users — guides through initialization, architecture review, and cleanup.

    119 GitHub stars~718 tokensUpdated 15 days ago
    Auto-check passed
  • Harness Mode

    k1ein-chen/Harness-Starter

    Switch Harness workflow mode (full/hotfix/tweak) and development phase (design/build/fix).

    119 GitHub stars~273 tokensUpdated 15 days ago
    Auto-check: notes
  • Tech Review

    k1ein-chen/Harness-Starter

    Reviews technical decisions before implementation. An agent skill from k1ein-chen/Harness-Starter.

    119 GitHub stars~396 tokensUpdated 15 days ago
    Auto-check passed
  • Verify Goal

    k1ein-chen/Harness-Starter

    Independently verifies whether a completed task meets its defined goal conditions.

    119 GitHub stars~502 tokensUpdated 15 days ago
    Auto-check passed
  • Harness Gc

    k1ein-chen/Harness-Starter

    Garbage Collection Agent — 定期扫描项目健康状态,检测文档/代码一致性漂移,自动发起修复提案。

    119 GitHub stars~360 tokensUpdated 15 days ago
    Auto-check passed

Works with

Questions about Handover

What does Handover do?

将当前会话中的技术决策、运维流程或阶段性研发进展,归档为标准工程文档(ADR / SOP / Handover),并自动更新模块内的 README 归档索引。. Handover is an agent skill from k1ein-chen/Harness-Starter.

When should I use Handover?

Handover fits situations like: tasks that involve Architecture decision records; tasks that involve Operations and SOPs; tasks that involve Technical documentation.

How do I install Handover in Claude Code?

Run `npx skills add k1ein-chen/Harness-Starter --skill handover -a claude-code`. Or copy the skill folder (.agents/skills/handover in k1ein-chen/Harness-Starter) into .claude/skills/handover in your project. Claude Code loads it when a task matches its description.

How do I install Handover in Codex?

Run `npx skills add k1ein-chen/Harness-Starter --skill handover -a codex`. Or copy the skill folder (.agents/skills/handover in k1ein-chen/Harness-Starter) into .agents/skills/handover in your project. Codex loads it when a task matches its description.

Can I use Handover in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add k1ein-chen/Harness-Starter --skill handover -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/handover, .gemini/skills/handover, .github/skills/handover and .opencode/skills/handover in your project.

What does Handover need to run?

Going by SKILL.md and its folder, Handover needs the command-line tools its instructions call (git).

Does Handover access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Handover safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Handover use?

Handover is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Handover use?

About 752 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.2k tokens, read only when the agent opens those files.

What are the alternatives to Handover?

Skills that share tags, products or a category with Handover: Research Init (brycewang-stanford/Auto-Empirical-Research-Skills, 4.5k stars), Agentsop Aider (agentsope/SkillAlchemy, 466 stars), Doc Sync (JetBrains/ideavim, 10k stars) and Mermaid Diagrams (jjmartres/opencode, 133 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Handover?

k1ein-chen (a GitHub user) maintains it in k1ein-chen/Harness-Starter, which has 119 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on September 24, 2026.

Source: k1ein-chen/Harness-Starter on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.