菜单
仅在用户显式调用 `$task`（Claude Code 中为 `/task`）时使用。创建新的 Runtime Task，或恢复、查看用户指定且已包含 `.runtime/state.json` 的现有 Task；确定唯一 Active Task，建立可信 Task Context，并通过显式工作单元、产物登记、证据和完成门禁维持可恢复状态。其他 Skill、Agent、任务复杂度或持久化需要不触发本 Skill。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | task |
| description | 仅在用户显式调用 `$task`（Claude Code 中为 `/task`）时使用。创建新的 Runtime Task，或恢复、查看用户指定且已包含 `.runtime/state.json` 的现有 Task；确定唯一 Active Task，建立可信 Task Context，并通过显式工作单元、产物登记、证据和完成门禁维持可恢复状态。其他 Skill、Agent、任务复杂度或持久化需要不触发本 Skill。 |
把用户明确启动的 Task 展开到所有参与者都能接手的位置。task 管理任务生命周期、承诺、当前状态和产物入口；shape、grill、dev、review、test 等 Skill 仍拥有各自的专业判断。
创建或恢复 Task 时读取 Task Runtime。需要建立或修改承诺时读取 决策来源与修改权；判断哪些变化应进入历史时读取 Task Timeline。
一个 Session 同时只有一个 Active Task。用户给出的 task id、task.md 绝对路径或明确的 new | resume 指令说了算：
new：创建新的 Runtime Task；resume <task-id|absolute-task.md-path>：恢复指定 Runtime Task；$task、又没有 Active Task：查找当前仓库和 ~/.longrein/studio/tasks/ 中包含 .runtime/state.json 的未完成候选，让用户选择 resume 或 new；即使只有一个候选也不猜测。旧式、只有 task.md 而没有 .runtime/state.json 的目录不是 Runtime Task，不迁移、不接管，也不直接改写。用户仍要继续其目标时创建新的 Runtime Task，并把仍然有效的原始请求作为输入重新塑形。
选定后先运行 longrein task show <task.md> 核验状态，再在用户可见消息中宣布 Active Task: <task.md 的绝对路径>。仓库里碰巧存在其他 task.md 不表示它们属于当前工作。
新任务使用稳定的 <YYYYMMDD>-<slug> 标识，并只选择一个位置：
目标项目已有、未追踪且已被本地忽略的 studio/：<repo-root>/studio/tasks/<task-id>/
其他情况： ~/.longrein/studio/tasks/<task-id>/
使用项目内 studio/ 前运行：
git check-ignore -q studio/ || printf '\nstudio/\n' >> "$(git rev-parse --git-path info/exclude)"
不要修改 .gitignore，不要暂存或提交本地 Task 产物。若 studio/ 已被追踪或 Task 产物本身需要交付，使用用户目录下的位置。
用 Runtime 创建，不手工建立核心文件：
longrein task create <task-dir> \
--id <task-id> \
--request "<用户原始请求>" \
--repository <repo-root>
Runtime 创建 status: shaping 的 Task，保留原始请求，并生成 .runtime/state.json、task.md 与 timeline.md。仓库不是任务对象时省略 --repository。
新 Task 先让 shape 接触真实对象。Goal、Scope 与完成条件尚未成立时保持 unresolved，不要为了填满视图提前制造承诺。需要理解生成视图的固定章节时读取 Task Context demo，但不能复制模板后直接编辑 task.md。
调查和用户裁决足以支撑承诺后，通过 longrein task context 建立 Goal、Scope、Non-goals、Completion Evidence、Must Preserve、Git 意图、Task Operating Envelope 与下一步。关键用户决定使用任务内唯一的 UD-###；Agent 的 AD-### 留在所属专业产物。
首次建立承诺不需要 --decision。已经生效的 Goal、Scope、Non-goals、Completion Evidence、Must Preserve 或 Git 意图准备变化时，先按 Task Context report demos 向用户说明冲突、证据、代价和影响；用户明确批准后，使用新的 UD-### 和 --decision UD-### 更新。事实、假设或 Operating Envelope 变化不冒充用户决定。
激活、首次建立可信 Context 或发生实质变化时，按 report demo 向用户报告变化量；普通工作进度不重复整份 task.md。
Task Runtime 不使用 Hook，也不记录普通工具调用。每个会修改代码、专业产物、任务判断或验证状态，并且需要交接的工作单元遵循同一边界：
longrein task work start，写清 Now 与预期 Next；task finding、task artifact、task evidence 或 task context 登记已经成立的变化；task work finish，阻塞时运行 task work block；task doctor。不要为每次读取、搜索或命令创建工作单元。边界保护的是可交接状态：不能让仓库变化、产物 hash、Task 视图和声明结果在交接时互相矛盾。
.runtime/state.json 是核心机器状态，task.md 和 timeline.md 是 Runtime 生成视图。task.md 的固定形状见 Task Context demo，timeline.md 的固定形状见 Task Timeline demo；两个 Demo 只用于理解生成产物，不能复制后手工维护。任何 Skill 都不能直接编辑这三个文件。doctor --fix 只能重建两个视图，不能把未登记的代码变化、产物漂移或手工文字承认为有效状态。
如果 Task Command 不存在、执行失败或状态损坏，停止依赖该状态更新的工作并报告阻塞；不要回退成手工编辑核心文件。已经产生的专业产物保持原样并明确标为尚未同步，不能声称 Task 已可交接或完成。
shape；grill；dev；review；test；walkthrough。Skill 是工作单元使用的能力，不是 Task 生命周期。Task 状态由 Runtime 根据真实推进维护为 shaping | ready | working | waiting | blocked | verifying | complete，不要求所有任务经过固定阶段。
只有可信 Task Context 已建立、没有活动或阻塞的工作单元、每项 Completion Evidence 都已通过、关键产物存在且 hash 一致、仓库变化已在工作单元边界解释、生成视图无漂移时，才运行：
longrein task doctor <task.md>
longrein task complete <task.md> --summary "<用户可观察的完成结果>"
完成门禁失败时修订真正的代码、专业产物、证据或 Task Command；不要绕过门禁，也不要创建第二份任务摘要。
在用户需要真正理解任何非平凡对象时使用，包括需求、计划、设计、代码、diff、分支、评审结论、测试结果、故障、进行中的方向或已完成成果。读取对象本身和必要上下文，为没有读过当前对象的读者写成连续、自包含、能检查证据并继续判断的 Walkthrough；它可以发生在工作前、中、后任何位置，不用摘要、文件清单或术语堆叠冒充理解。
在用户明确要求实现功能、修改代码、修复缺陷、落实已确认的评审问题，或执行范围明确的重构与迁移时使用。进入真实代码，沿行为或错误路径追到局部根因，用贴近变化的证据确认结果，交付可审查的代码变化。方向或关键结构还没定、用户只要求诊断，或根因会改变任务承诺、公共契约、数据所有权或关键系统形态时交给 shape；独立 review、完整测试或单纯解释不由本 Skill 承担。
在非平凡任务自然收尾时判断是否存在可复用经验，或在 Skill、提示词与长期规则出现可重放的触发、执行、边界或成本偏差时使用。沿真实轨迹决定经验是否值得改变未来，以及应进入哪个最窄作用域；行为性 Skill 变化需要证据和用户批准，没有经验时不制造产物。
在 Shape 已经形成候选方向，或用户带着现有计划、设计、提案和决定，要求拷问、挑战、压力测试、补齐隐含决定或确认是否足以继续时使用。把对象展开成有依赖关系的决策树，按当前前沿分轮提出多个问题，让用户对推荐选项作出裁决。开放探索和生成方向由 shape 负责；所有者缺席时对成文产物做独立检查由 review 负责。
仅在用户显式调用 `$prompt` 时使用。结合真实任务、输出和用户反馈，帮助用户看清表达与上下文怎样影响了结果。先调查再提纯；如果真正需要改变的是方向、时间线或长期能力，转入 shape、rewind 或 evolution，不把所有问题都改写成提示词。
对需求、设计、计划、代码、diff、MR 或交付物做独立冷读，从当前 Task Context 锁定 scope、Git baseline 与 Task Operating Envelope，检查行为风险、变更纪律、架构维护，以及决定授权、专业产物、实现和 Task Runtime 状态是否一致，并在报告前独立证伪每个 finding。用于实现 Phase 完成后的轻量审查、最终综合审查、用户要求 review、判断 MR/方案能否前进、检查修复是否优雅而非 hack、寻找隐藏风险，或重要产物需要在测试、合并或交付前接受独立压力时。用户明确要求直接实现或修复、没有可审查对象、只需解释现状，或为了"更严格"给小改动制造评审团时不要触发。