菜单
Create or modify hidden per-workdir heartbeat extensions for this harness. Use when asked to add pre-heartbeat prompt injection, post-heartbeat accounting/export/audit, or customize heartbeat lifecycle behavior for this deployed agent.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when designing or scaffolding a Codex-based long-running business agent, including deciding what belongs in AGENTS.md, skills, and subagents.
Use when work must be tracked across heartbeats, including durable multi-step todos, time-bound commitments, or scheduled reminders.
Default workflow for non-trivial iterative heartbeats. Use when advancing the assigned goal, continuing a task, handling a non-trivial human request, or doing work that needs an episode record and evaluator. Skip only for quick human responses, acknowledgements, status syncs, or other simple mailbox interactions.
On-demand workflow for software project development. Use when the task is to build or substantially rework a software system/module/tool. Drives an Assume → PRD → Plan state machine, each transition gated by human approval over mailbox.
Operate the mailbox system with three commands -> mailbox-send for sending messages, mailbox-read for reading messages, and mailbox-contacts for listing contacts.
| name | heartbeat-extension-authoring |
| description | Create or modify hidden per-workdir heartbeat extensions for this harness. Use when asked to add pre-heartbeat prompt injection, post-heartbeat accounting/export/audit, or customize heartbeat lifecycle behavior for this deployed agent. |
Heartbeat extensions are runtime files, not agent-facing skills. Put them under .harness/heartbeat.
.harness/heartbeat/
pre/*.json
post/*.json
scripts/*
Pre manifests inject stdout into the next heartbeat prompt:
{
"name": "custom-context",
"command": ["uv", "run", "python", ".harness/heartbeat/scripts/custom_context.py"],
"timeout_ms": 5000,
"inject_as": "prompt_section"
}
Post manifests receive the heartbeat result through HEARTBEAT_PAYLOAD_FILE and do not inject prompt text:
{
"name": "usage-export",
"command": ["uv", "run", "python", ".harness/heartbeat/scripts/usage_export.py"],
"timeout_ms": 5000
}
HEARTBEAT_PAYLOAD_FILE.AGENT_DIR, HEARTBEAT_PHASE, and HEARTBEAT_EXTENSION_NAME if needed.Runtime/metrics.json, Runtime/events.jsonl, or pending message markers.