source_rel: 07_IT运维与系统工具/01_Hermes机器人运维/长任务Git仓库追踪与交接SOP.md

text:
---
title: 长任务Git仓库追踪与交接SOP
category: IT运维与系统工具/Hermes机器人运维
tags: ["Hermes", "长任务", "Git", "REPO_DESCRIPTION", "交接", "版本管理"]
source: Hermes 多 profile 每日候选汇总，经 meow-chan 复核后提交三人审批
created_at: 2026-05-21
visibility: studio-internal
safety: 不含密钥、token、cookie、AppSecret、私聊原文、个人完整流水或动态项目待办
---

title: 长任务Git仓库追踪与交接SOP


heading: 长任务Git仓库追踪与交接SOP

text: # 长任务Git仓库追踪与交接SOP

title: 长任务Git仓库追踪与交接SOP


heading: 适用场景

text:
## 适用场景

用于多轮、多文件、跨会话、可交接、后续可能由其他机器人继续处理，或会产出持久交付文件的任务。短平快的一次性问答或临时草稿可以不建仓库。

title: 长任务Git仓库追踪与交接SOP


heading: 启动判定

text:
## 启动判定

任务开始时先判定：

1. `one_off`：一次性回答、简单文件转换或无需后续追踪的任务。
2. `repo_required`：需要长期修改、跨多个文件、交付可复用文件、需要验收记录或后续接手。
3. `repo_existing`：用户已给出或当前工作区已有可继续使用的仓库。

判定为 `repo_required` 或 `repo_existing` 时，应维护安全 `.gitignore`，避免把 `.env`、密钥、缓存、日志、虚拟环境、原始私聊、临时大文件提交进仓库。

title: 长任务Git仓库追踪与交接SOP


heading: 仓库交接文件

text:
## 仓库交接文件

仓库根目录应维护 `REPO_DESCRIPTION.md`，至少包含：

- 项目目标和当前交付物；
- 关键目录结构；
- 运行/构建/验证命令；
- 当前已知限制和待办；
- 不应提交或外传的敏感内容边界；
- 远程仓库地址和最近一次有效 commit（不包含 token 或私钥）。

每次实质需求、范围、架构、数据来源或交付行为变化后，应更新 `REPO_DESCRIPTION.md`，commit 并 push。

title: 长任务Git仓库追踪与交接SOP


heading: NAS 任务映射边界

text:
## NAS 任务映射边界

长任务仓库的 NAS 映射只允许写入授权的远程仓库任务映射目录，用于保存简洁 metadata：仓库名、远程地址、维护 profile、本地工作路径、当前 commit、更新时间和一句话说明。不得把源码、聊天记录、密钥、原始用户资料或过程日志复制进 NAS 映射文件。

除授权映射目录外，任何 NAS 写入仍需按共享知识库审批/二次确认规则执行。

title: 长任务Git仓库追踪与交接SOP


heading: 验收与回复

text:
## 验收与回复

向用户回复阶段性结果时，给出本地路径、远程地址、commit、`REPO_DESCRIPTION.md` 是否已更新，以及 NAS 映射是否已按授权范围更新。若没有建仓库，应说明判定为 `one_off` 的原因。

title: 长任务Git仓库追踪与交接SOP