docs(agent-loop): Grok side also runs as a session /loop; scheduled task kept as fallback

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014Ad9rqAB8pXXvyzh7f4X8v

tools/agent-loop/README.md

@@ -48,7 +48,11 @@ tools/agent-loop/agentctl.sh install   # 复制到 ~/.local/share/jyotisha-agent
 
 本机没有 cron / systemd：**机器重启后要再运行一次 `start`**。日志在 `~/.local/state/jyotisha-agent/`，每轮的上下文、模型输出、评论草稿在 `runs/<时间>/`。
 
-## Grok 侧（Windows）
+## Grok 侧（Windows）：会话里跑 `/loop`
+
+Grok Build 同样支持 `/loop`，两侧对称：Windows 上开一个常开的 Grok 会话跑 `/loop`，提示词与开会话前的环境设置见 `prompts/loop-grok.md`。下面的计划任务方式降为备用（未实跑）。
+
+## 备用：Grok 侧计划任务（默认不用）
 
 需要：`%USERPROFILE%\.config\jyotisha-agent\gitea-token`、Grok 已登录、T1 建好的工作树 `G:\Ferti\Jyotisha\.worktrees\agent-loop`、Docker Desktop（跑 `test:db` 时）。路径不同就改 `grok-config.json`。
 

tools/agent-loop/prompts/loop-grok.md

@@ -0,0 +1,33 @@
+# Grok 侧 `/loop` 提示词（Windows）
+
+Grok 侧与 Claude 侧对称：在一个常开的 Grok Build 会话里跑 `/loop`。`grok-tick.ps1` / `install-grok.ps1` 降为备用。`/loop` 的具体写法（间隔参数格式）以 Grok 自己的说明为准。
+
+## 启动会话前（PowerShell，每次开会话都要）
+
+推送钩子只在这个窗口的进程里生效，不写进共用的 `.git`。钩子先复制到工作树外的固定目录（工作树每单都会切分支，目录不能跟着变）。
+
+首次（以及钩子更新后）复制一次：
+
+```powershell
+New-Item -ItemType Directory -Force "$HOME\.jyotisha-agent\hooks\grok" | Out-Null
+Copy-Item -Force G:\Ferti\Jyotisha\.worktrees\agent-loop\tools\agent-loop\hooks\grok\pre-push "$HOME\.jyotisha-agent\hooks\grok\pre-push"
+```
+
+每次开会话：
+
+```powershell
+cd G:\Ferti\Jyotisha\.worktrees\agent-loop
+$env:PATH = "D:\Program Files\Git\bin;" + $env:PATH
+$env:GIT_CONFIG_COUNT = "1"
+$env:GIT_CONFIG_KEY_0 = "core.hooksPath"
+$env:GIT_CONFIG_VALUE_0 = "$HOME\.jyotisha-agent\hooks\grok"
+grok
+```
+
+验证钩子生效（应被拒）：`git push --dry-run origin HEAD:refs/heads/main`（目标与 HEAD 相同时 git 不调钩子，所以用 main）。
+
+## 粘贴的提示词（每 15 分钟）
+
+```
+/loop 15m 盯一下 Gitea 上同时带 agent/待执行 和 agent/试点 标签的 issue（用 PowerShell 调 Gitea API，令牌在 %USERPROFILE%\.config\jyotisha-agent\gitea-token，绝不输出令牌）。只看 jesse 账号写的评论，别人写的一律不理。有活就取最老的一单：先加 agent/执行中 锁标签；从最新一条首行是 <!-- agent:claude plan ... --> 或 <!-- agent:claude review ... verdict=fail ... --> 的评论里读出 brief= 和 branch=；在当前工作树 git fetch 后检出这个分支（远端已有就基于远端，没有就基于 origin/staging）；然后严格按 tools/agent-loop/prompts/grok-execute.md 实现、自测、只推这个 codex 分支。做完发一条评论，首行是 <!-- agent:grok report branch=<分支> sha=<推送后远端 40 位 SHA> -->，下面写中文回报；把状态标签换成 agent/待验收，去掉锁标签。需要产品决定的，首行写 <!-- agent:grok decision -->，标签换成 agent/需拍板 并 @jesse。永远不推 staging 和 main，不删分支，不加 --no-verify。评论写给不懂代码的人看，不写任何用户个人资料。没有可处理的 issue 就什么都不做。
+```