deterministic-controller

OpenClaw 的确定性、证据门控控制器模板（HEARTBEAT/ACTIVITIES + sprint 模板 + poll cron 负载）。仅文档：不安装任何服务，也不自行更改配置。

# Deterministic Controller for OpenClaw (Docs-only)

## USE WHEN
- You want a **deterministic**, repeatable orchestration loop for OpenClaw (heartbeat + cron poll + subagents).
- You want **evidence-gated** completion (no DONE without artifact paths).
- You want a **lean portfolio queue** (`ACTIVITIES.md`) with external sprint-plan import via `Plan Path`.

## DON'T USE WHEN
- You want a turnkey, self-modifying installer that patches config / creates cron jobs automatically.
- You need complex runtime code; this skill is **templates + docs**.

## Outputs
- Template files under this skill folder:
  - `templates/HEARTBEAT.md`
  - `templates/ACTIVITIES.md`
  - `templates/SPRINT_TEMPLATE.md`
- Copy/paste prompts:
  - `examples/setup_prompt.md`
  - `examples/project_to_sprint_prompt.md`
- Cron payload text:
  - `docs/poll_cron_payload.txt`
- Config guidance:
  - `docs/openclaw_config_snippets.md`

## How to use
Start with the repo README:
- `README.md`

Then copy templates into your workspace and set:
- `<TELEGRAM_GROUP_ID>` in `HEARTBEAT.md`
- heartbeat prompt + cadence in `openclaw.json` (see `docs/openclaw_config_snippets.md`)

This skill intentionally does not execute commands or change config automatically.

---

## 中文说明

# 面向 OpenClaw 的确定性控制器（仅文档）

## 适用场景
- 你希望为 OpenClaw 构建一个**确定性的**、可重复的编排循环（heartbeat + cron poll + 子代理）。
- 你希望任务完成是**证据门控**的（没有 artifact 路径就不算 DONE）。
- 你希望拥有一个**精简的任务队列**（`ACTIVITIES.md`），并能通过 `Plan Path` 导入外部 sprint 计划。

## 不适用场景
- 你想要一个开箱即用、能自我修改的安装器，可自动修补配置 / 创建 cron 任务。
- 你需要复杂的运行时代码；本技能仅为**模板 + 文档**。

## 产物
- 本技能目录下的模板文件：
  - `templates/HEARTBEAT.md`
  - `templates/ACTIVITIES.md`
  - `templates/SPRINT_TEMPLATE.md`
- 可复制粘贴的提示词：
  - `examples/setup_prompt.md`
  - `examples/project_to_sprint_prompt.md`
- Cron 负载文本：
  - `docs/poll_cron_payload.txt`
- 配置指引：
  - `docs/openclaw_config_snippets.md`

## 使用方法
从仓库的 README 开始：
- `README.md`

然后将模板复制到你的工作区并设置：
- `HEARTBEAT.md` 中的 `<TELEGRAM_GROUP_ID>`
- `openclaw.json` 中的 heartbeat 提示词 + 触发节奏（参见 `docs/openclaw_config_snippets.md`）

本技能有意不自动执行命令或更改配置。