handoff-clean 是一个面向协作交接的场景技能,核心目标是让接手者能够依据记录继续工作,同时保证不含机密信息,也不出现把未完成工作说成已完成的情况。
用途 用于在阶段性工作结束时撰写交接说明。它不是通用的提交信息生成器,重点在于把“改动、检查、未验证项、分支状态”四类事实写清楚,便于他人复核与续做。
主要能力与要求 交接由四个简短部分组成:一、改动了什么,并给出路径;二、运行了哪项检查,以及它打印了什么;三、哪些内容没有被验证;四、分支名称以及是否已推送。 安全约束明确:不得包含令牌、密码、私有客户名称或本机机密。状态约束明确:除非合并提交确实存在,否则不得声称工作已经合并。
使用方式 按上述四部分撰写交接内容后,在 work 目录写入 practice-receipt.json,字段包括 schema(creator-os.practice-receipt.v1)、skill(handoff-clean)、finishedAt(ISO 时间)、outcome(如 pass)、command(实际运行的命令)与 summary(一句可供他人核验的摘要)。应填写实际遵循的技能与实际运行的命令;若该命令失败,则结果应记为失败。随后运行: node tools/receipt-check/check-receipt.mjs practice-receipt.json 退出码为 0 即表示字段校验通过。该工具始终报告 signed: false。
适用场景 适用于多人协作或跨班次接手、需要留下可复核记录的开发或内容工作流程,尤其是涉及分支与检查结果时需要如实交代的场景。
限制 资料仅给出上述四部分内容与凭据格式、校验脚本用法,未提供更多自动化生成能力、集成方式、收费或平台支持信息,这些方面暂未提供。校验仅做字段检查,且不提供签名真实性保证(始终 signed: false)。