timebox
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseTimebox
Timebox
When to use
何时使用
Use this skill when the user gives both a complete task and a duration or exact deadline and requires the work plus decisive validation to finish inside that limit. An invocation may look like or .
/timebox 10 minutes fix and test the parser/timebox by 16:00 EDT verify the release artifactIf the task or limit is missing, ask one concise question before starting. Resolve an ambiguous date, time, or zone before admission. Require a positive limit that yields one absolute deadline.
当用户同时给出完整任务、时长或确切截止时间,且要求工作及决定性验证需在该时限内完成时,使用此skill。调用示例如下: 或 。
/timebox 10 minutes fix and test the parser/timebox by 16:00 EDT verify the release artifact若任务或时限缺失,在开始前先提出一个简洁的问题。在确认前需明确模糊的日期、时间或时区。要求提供一个可转化为绝对截止时间的有效时限。
Required composition
必要组成部分
Before admission:
- Load and acquire a fresh clock anchor. Use its
always-current-datetimevalue as the start and calculate the absolute deadline with a tool.captured_at - Load and define the complete outcome, decisive proof, scope, authority, unknowns, and forbidden outcomes.
starting-point - Load and keep the full outcome and proof fixed while allowing a faster safe route.
outcome-bounded-work - Load and check for conflicting scope, an impossible deadline, missing proof, or dependencies that cannot fit.
logic-audit
Stop with when a required skill cannot load. Do not replace current instructions with remembered text.
contract-unavailable: <skill-name>确认前:
- 加载并获取最新的时钟锚点。以其
always-current-datetime值作为起始时间,通过工具计算绝对截止时间。captured_at - 加载,定义完整成果、决定性证据、范围、权限、未知因素及禁止的成果。
starting-point - 加载,在允许选择更快捷安全路径的同时,保持完整成果和证据固定不变。
outcome-bounded-work - 加载,检查是否存在范围冲突、无法实现的截止时间、缺失的证据或无法适配的依赖项。
logic-audit
若无法加载所需skill,返回。请勿用记忆中的文本替换当前指令。
contract-unavailable: <skill-name>Admission gate
准入门槛
Start only when the task, acceptance criteria, and deadline are unambiguous; every required input, permission, dependency, credential, and human decision is available or predictably bounded; each action and retry has a maximum duration; and the complete execution plan plus a protected validation reserve fits before the deadline.
If admission fails, return , name the failed condition, and request a longer limit or an explicit scope change. Do not begin work or promise completion from an unbounded estimate.
TIMEBOX_NOT_STARTED仅在满足以下条件时方可启动:任务、验收标准和截止时间明确无误;所有必要的输入、权限、依赖项、凭证和人工决策均已就绪或可预测界定;每个操作和重试都有最长时长限制;完整执行计划加上预留的验证时间可在截止时间前完成。
若准入失败,返回,说明失败原因,并请求延长时限或明确调整范围。请勿基于无边界估算开始工作或承诺完成。
TIMEBOX_NOT_STARTEDExecution contract
执行协议
- Record the start, deadline, work cutoff, validation reserve, outcome, and decisive proof before the first work action. Use as the field template and read the timebox record before creating the record.
assets/timebox-record.json - Set the work cutoff to the deadline minus the protected validation reserve.
- Choose the fastest route that preserves scope, quality, safety, and proof.
- Before each action, compare its maximum duration with the remaining work budget. Do not start an action that can cross the work cutoff.
- Set command and tool timeouts no later than the applicable cutoff. Avoid open-ended retries, waits, polls, and background work.
- Count work as incomplete while it remains queued, delegated, pending approval, or unverified.
- If a required step no longer fits, use a faster route only when it preserves the complete contract. Otherwise return immediately.
TIMEBOX_FAILED - Begin decisive validation at the work cutoff or earlier. Implementation work may not consume the validation reserve.
- Capture a completion timestamp after every decisive check passes. Never reset or extend the deadline because of latency, retry, clarification, or failure.
- 在首次执行工作前,记录起始时间、截止时间、工作截止点、预留验证时间、成果及决定性证据。以作为字段模板,创建记录前请阅读timebox记录文档。
assets/timebox-record.json - 将工作截止点设置为截止时间减去预留验证时间。
- 选择能保留范围、质量、安全性和证据的最快路径。
- 在每次操作前,将其最长时长与剩余工作预算进行对比。请勿启动可能超出工作截止点的操作。
- 将命令和工具超时时间设置为不晚于相应的截止点。避免无限制的重试、等待、轮询和后台工作。
- 若工作仍处于排队、委托、待批准或未验证状态,则视为未完成。
- 若某个必要步骤无法在时限内完成,仅当能保留完整协议时才可选择更快捷路径。否则立即返回。
TIMEBOX_FAILED - 在工作截止点或更早时间开始决定性验证。实现工作不得占用预留验证时间。
- 在每次决定性检查通过后记录完成时间戳。绝不能因延迟、重试、澄清或失败而重置或延长截止时间。
Completion decisions
完成判定
Return only when the full accepted outcome is complete, every decisive validation check passed, final evidence was available before the absolute deadline, the completion timestamp is at or before the deadline, and no required work remains queued, delegated, pending approval, or unverified.
TIMEBOX_PASSReturn when execution began but any pass condition is unproved by the deadline. State completed work, validation run, remaining work, side effects, completion timestamp, and deadline. Late success remains a failure for that invocation.
TIMEBOX_FAILEDReturn when admission fails. This is the correct result when the requested guarantee cannot be supported inside the limit.
TIMEBOX_NOT_STARTED仅当以下所有条件满足时,返回:完整的认可成果已完成,所有决定性验证检查通过,最终证据在绝对截止时间前可用,完成时间戳不晚于截止时间,且无必要工作处于排队、委托、待批准或未验证状态。
TIMEBOX_PASS若已开始执行但截止时间前未满足任何通过条件,返回。说明已完成的工作、已执行的验证、剩余工作、副作用、完成时间戳及截止时间。即使后续成功,此次调用仍视为失败。
TIMEBOX_FAILED若准入失败,返回。当无法在时限内支持所请求的保证时,这是正确结果。
TIMEBOX_NOT_STARTEDSafety rules
安全规则
- Never report implementation-only or partial progress as completion.
- Never count queue submission, dispatch, acknowledgment, or a background process as completed work.
- Never weaken, skip, or move validation after the deadline to manufacture a pass.
- Never conceal a deadline miss or rush an irreversible or sensitive action.
- Preserve safe intermediate state and report it when stopping.
- Treat a new or changed task as a new timebox requiring a fresh user-stated limit.
- 绝不能仅将实现阶段或部分进度报告为完成。
- 绝不能将队列提交、调度、确认或后台进程视为已完成工作。
- 绝不能为了伪造通过结果而弱化、跳过或延后截止时间后的验证。
- 绝不能隐瞒截止时间逾期情况,或仓促执行不可逆或敏感操作。
- 保留安全的中间状态,并在停止时进行报告。
- 将新任务或变更后的任务视为需要用户指定新时限的全新timebox。
Output
输出内容
At admission, state the start, deadline, complete outcome, decisive validation, and protected validation reserve. At closeout, lead with , , or , then provide the completion timestamp, deadline, evidence, and remaining work.
TIMEBOX_PASSTIMEBOX_FAILEDTIMEBOX_NOT_STARTED准入时,说明起始时间、截止时间、完整成果、决定性验证及预留验证时间。结束时,先返回、或,然后提供完成时间戳、截止时间、证据及剩余工作。
TIMEBOX_PASSTIMEBOX_FAILEDTIMEBOX_NOT_STARTEDResources
资源
- Read the timebox record before recording admission or closeout fields.
- Use as the machine-readable field template.
assets/timebox-record.json - Use for admitted, rejected, and passed response shapes.
examples/ - Use for trigger, rejection, behavior, failure, recovery, and speed cases.
evals/ - Run from this skill directory to execute
mise run ciandscripts/checks.scripts/tests/
- 在记录准入或结束字段前,请阅读timebox记录文档。
- 使用作为机器可读的字段模板。
assets/timebox-record.json - 使用查看已准入、已拒绝及已通过的响应示例。
examples/ - 使用处理触发、拒绝、行为、失败、恢复及速度相关场景。
evals/ - 在此skill目录下运行以执行
mise run ci和scripts/中的检查。scripts/tests/