桌面应用开发工具【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/gh_mirrors/ec/EcoPaste点击查看免费下载本指南面向在 EcoPaste 这类接入 Trellis 工作流的仓库中开发/协作的工程师与 AI Agent完整解析.cursor/commands/trellis-continue.md这条继续当前任务命令的四个执行步骤、状态路由决策表与阶段规则并结合.trellis/目录下的脚本源码get_context.py、workflow_phase.py讲清底层机制。读完你将掌握如何一键加载会话上下文、如何根据task.json.status与规划产物prd.md / design.md / implement.md / jsonl定位正确的恢复步骤以及如何在 Plan / Execute / Finish 三阶段间正确穿梭。一、命令定位为什么需要一条继续命令AI 驱动的开发会话天然具有中断性——一次长任务可能跨越多个会话、多次终端窗口、甚至多个 Agent 平台Claude Code、Cursor、OpenCode、Codex 等。会话上下文会随聊天压缩丢失而文件不会丢。Trellis 工作流的核心原则之一就是持久化一切research、decisions、lessons 全部落盘因此恢复的关键不在于回忆上次聊了什么而在于读取仓库里已经写好的状态。.cursor/commands/trellis-continue.md正是为此设计的入口命令。它的定位在文档第一段就写得很清楚Resume work on the current task — pick up at the right phase/step in.trellis/workflow.md.它本身不承载完整流程而是引导你回到 workflow.mdTrellis 流程的唯一权威定义并在正确的 Phase / Step 上继续。命令全文围绕 4 个步骤展开加载当前上下文Step 1加载阶段索引Step 2判定自己处在哪个阶段Step 3含路由决策表加载具体步骤的详细指引Step 4二、Step 1加载当前会话上下文恢复工作的第一步是弄清现在是什么状态。执行python3 ./.trellis/scripts/get_context.py这条命令的输出由 session_context.py 生成默认text模式下会依次给出输出区块内容用途DEVELOPER当前开发者身份来自.trellis/.developer确认工作区归属GIT STATUS当前分支、工作区是否干净、未提交变更列表判断上次是否遗留未提交代码RECENT COMMITS最近 5 条提交git log --oneline回溯任务进展CURRENT TASK当前活跃任务路径、来源session source、名称与status字段路由决策的第一依据ACTIVE TASKS全部未归档任务树含子任务进度了解任务层级JOURNAL FILE当前会话日志文件与行数2000 行上限判断会话记录是否接近轮转阈值PATHSworkspace / tasks / spec 目录后续操作入口从源码看get_context.py是典型的 argparse 入口见 get_context.py支持四个输出模式python3 ./.trellis/scripts/get_context.py # 默认完整会话上下文 python3 ./.trellis/scripts/get_context.py --mode record # 精简版任务 git 最近提交 python3 ./.trellis/scripts/get_context.py --mode packages # 列出包与 spec 层级 python3 ./.trellis/scripts/get_context.py --mode phase # 阶段索引Step 2 用命令文档中特别强调了一个设计意图get_context.pyshows the active tasksstatusfield… this commandreplaces the user needing to remember the Trellis flow; it does not itself approve implementation.——即该命令只负责帮你想起流程本身不构成实现授权真正的实现仍然要等task.py start之后。三、Step 2加载阶段索引Phase Index在拿到基本上下文后加载流程总览python3 ./.trellis/scripts/get_context.py --mode phase这会从 workflow.md 的## Phase Index小节中提取出三阶段的精简总览不含各步骤详细正文并保留路由 skill 映射信息Phase 1: Plan → classify, get task-creation consent, then write planning artifacts Phase 2: Execute → implement only after task status is in_progress Phase 3: Finish → verify, update spec, commit, and wrap upPhase 1Plan步骤 1.0 创建任务、1.1 需求探索产出prd.md、1.2 研究可选、1.3 配置上下文jsonl 策划、1.4 激活任务review 后task.py start、1.5 完成标准。核心纪律先规划后代码任务创建授权 ≠ 实现授权。Phase 2Execute步骤 2.1 实现、2.2 质量检查、2.3 按需回滚。前提是任务状态已进入in_progress。Phase 3Finish步骤 3.2 调试复盘按需、3.3 更新 spec[required]、3.4 批量提交[required]、3.5 收尾提醒。注意 3.1 已被合并进 2.2 与 3.4编号刻意保持稳定以免破坏外部引用。从 workflow_phase.py 的实现看--mode phase不带--step时调用get_phase_index()只截取## Phase Index到## Phase 1: Plan之间的内容并剥离[workflow-state:STATUS]面包屑块这些块由每轮的 hook 单独注入不属于阶段索引输出。四、Step 3核心——根据 status 与产物路由这是整条命令的核心价值所在不需要记 Trellis 流程只需要读 status 检查产物是否存在即可定位下一步。文档给出的完整路由决策表如下条件路由结果statusplanning且无prd.md→1.1加载trellis-brainstormstatusplanning且仅有prd.md判断任务轻重轻量任务可直接去1.4review复杂任务回到1.1补充design.mdimplement.mdstatusplanning且复杂任务产物齐全、但子代理 jsonl 未整理仅种子_example行→1.3配置上下文statusplanning且必需产物齐全、jsonl 已整理或处于 inline 模式→1.4请求开始 review只有用户确认后才运行task.py startstatusin_progress且实现未开始→2.1statusin_progress且实现完成但未检查→2.2statusin_progress且检查通过→3.3更新 spec→3.4提交statuscompleted罕见通常立即归档走归档流程archive flow4.1 路由背后的产物语义要正确路由必须理解各规划产物的含义见 workflow.md 的Planning Artifacts小节prd.md—— 需求、约束与验收标准。不要把技术设计或执行清单写进去。design.md—— 复杂任务的技术设计边界、契约、数据流、取舍、兼容性、上线/回滚形态。implement.md—— 复杂任务的执行计划有序检查清单、验证命令、评审门禁、回滚点。implement.jsonl/check.jsonl—— 子代理的 spec 与研究清单每行一个{file: ..., reason: ...}不替代implement.md。关键判断轻量任务可以只有 PRD复杂任务在task.py start之前必须同时具备prd.md、design.md、implement.md三个文件。在 EcoPaste 仓库的 tasks 归档目录 中可以看到两类实例轻量修复任务如06-30-fix-divider-deprecation、06-30-i18n-window-lifecycle-name只含task.json prd.md 两个 jsonl而复杂任务07-03-onboarding-admin-launch则同时包含design.md、implement.md正好印证了这一产物矩阵。任务目录统一遵循{MM-DD-name}/命名内部结构为.trellis/tasks/{MM-DD-name}/ ├── task.json # 元数据status / assignee / priority / children / hooks ├── prd.md # 需求与验收标准 ├── design.md # 复杂任务技术设计 ├── implement.md # 复杂任务执行计划 ├── research/ # 可选研究成果落盘 ├── implement.jsonl # 实现子代理的上下文清单 └── check.jsonl # 检查子代理的上下文清单4.2 三条阶段规则文档在路由表后给出了三条必须遵守的阶段规则与 workflow.md 的Rules小节一致阶段内按序执行——[required]步骤不得跳过[once]步骤已产出即视为完成——不要重复执行例如已有prd.md就说明 1.1 的部分工作已完成轻量任务可以凭prd.md直接进入 1.4允许回退到更早阶段——例如执行阶段发现prd.md有缺陷可回到 Phase 1 修正后再重新进入 Execute。4.3 路由表隐含的关键纪律planning 产物齐全 ≠ 可以直接实现必须进入 1.4先请求用户发起 review只有用户确认后才运行task.py startstart会把 status 翻转为in_progress面包屑随之切换。子代理平台 vs inline 平台在支持子代理分发的平台Claude Code、Cursor、OpenCode、Codex sub-agent 等implement.jsonl与check.jsonl都必须至少有一条真实条目才算可启动种子_example行不计而 Codex 的 inline 模式codex.dispatch_mode: inline见 config.yaml跳过 jsonl 策划Phase 2 直接由trellis-before-devskill 读取产物。completed状态在常规流程中基本不会出现因为task.py archive在同一个调用里既把 status 写成completed又把任务目录移入archive/活动任务解析器随即丢失指针——从源码注释看该状态块目前处于DEAD状态保留是为将来显式的in_progress → completed迁移做准备。五、Step 4加载具体步骤的详细指引一旦确定了要恢复的步骤编号如 1.1 / 2.1 / 3.3加载该步骤的完整正文python3 ./.trellis/scripts/get_context.py --mode phase --step X.X --platform cursor其中--step X.X指定步骤编号例如--step 1.1、--step 2.2--platform cursor指定当前平台用于过滤掉平台专属段落只保留适用于你的指令。从 workflow_phase.py 的实现看get_step()通过正则^####\s(\d\.\d)\b匹配workflow.md中的#### X.X标题正文一直截取到下一个####/##标题或---分隔线为止。例如--step 1.1会返回 1.1 需求探索步骤的完整正文包含trellis-brainstormskill 的使用指引。5.1 平台过滤的底层原理workflow.md中大量使用了成对的平台标记块[Claude Code, Cursor, OpenCode, codex-sub-agent, Kiro, Gemini, ...] 子代理分发平台的专属内容 [/Claude Code, Cursor, OpenCode, ...]filter_platform() 会用^\[(/?)([A-Za-z][^\[\]]*)\]\s*$识别开启/闭合标记对标记中的平台名做大小写不敏感 去分隔符的模糊匹配cursor、Cursor、claude-code、Claude Code都能对上丢弃标记行本身只保留标记块外的通用内容 包含当前平台的块内内容折叠因删块而产生的连续空行。还有一个值得注意的细节--platform codex会被 resolve_effective_platform() 映射为codex-inline默认或codex-sub-agent取决于 config 中codex.dispatch_mode原因是 Codex 子代理运行在fork_turnsnone隔离中、无法继承父会话的任务上下文因此默认走 inline 模式让主 Agent 直接改代码。六、命令的边界与配套流程trellis-continue.md在结尾的Reference小节明确声明了自己的边界Full workflow and detailed phase steps live in.trellis/workflow.md. This command is only an entry point — the canonical guidance is there.也就是说这条命令只是一个入口权威指南始终是 workflow.md。与之配套的收尾命令是 trellis-finish-work.md它负责在任务提交Phase 3.4之后归档任务task.py archive并记录会话日志add_session.py --title/--commit/--summary最终形成work commits→chore(task): archive ...→chore: record journal的提交顺序。两者配合即可覆盖中断恢复 → 继续执行 → 收尾归档的完整闭环。七、完整实战一次中断恢复的端到端走查将四个步骤串联起来一次典型的中断恢复流程是# 1. 恢复现场确认当前任务、git 状态、最近提交 python3 ./.trellis/scripts/get_context.py # 2. 若需要查看三阶段总览与路由映射 python3 ./.trellis/scripts/get_context.py --mode phase # 3. 依据 task.json 的 status 与产物存在性完成路由 # - planning 无 prd.md → 加载 trellis-brainstorm回到 1.1 # - planning 仅 prd.md → 轻量走 1.4复杂补 design.md implement.md 再走 1.4 # - planning 产物齐全 jsonl 未整理 → 1.3 策划 implement.jsonl / check.jsonl # - planning 产物齐全 jsonl 已整理 → 1.4 请求 review确认后 task.py start # - in_progress 未实现 → 2.1 # - in_progress 已实现未检查 → 2.2 # - in_progress 检查通过 → 3.3 更新 spec → 3.4 提交 # - completed → 归档流程 # 4. 加载目标步骤的详细指引按当前平台过滤 python3 ./.trellis/scripts/get_context.py --mode phase --step 2.1 --platform cursor配合任务生命周期命令见 workflow.md 的Task System小节你还可以在恢复过程中随时核对活跃任务python3 ./.trellis/scripts/task.py current --source # 显示当前任务与来源 python3 ./.trellis/scripts/task.py list [--status s] # 列出任务可按状态过滤 python3 ./.trellis/scripts/task.py validate name # 校验任务元数据八、实践建议与注意事项恢复会话先跑 Step 1不要凭记忆。get_context.py输出的CURRENT TASK区块里的status字段 prd.md等产物的存在性是路由的唯一合法依据。规划产物矩阵要分清轻量任务 PRD-only 是合法状态复杂任务缺design.md/implement.md则代表规划未完成不得task.py start。尊重[required]/[once]语义[required]步骤不可跳过[once]步骤有产出即跳过不要重复劳动。跨阶段回退是正常流程Execute 阶段发现问题可以回到 Plan 修正prd.md后重新进入这不是流程失败而是规划必须持久化到产物原则的体现。EcoPaste 仓库的验证基线见 spec/index.md前端pnpm lintpnpm tscRust 侧cd src-tauri cargo fmt cargo clippy -- -D warnings cargo test在 Phase 2.2 质量检查与 Phase 3.4 提交前务必把这两条基线跑绿。赞分享桌面应用开发工具【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/gh_mirrors/ec/EcoPaste点击查看免费下载相关推荐EcoPaste 仓库中的 AI 工作流恢复技能trellis-continue 的任务续接实战指南EcoPaste 仓库中的 AI 工作流恢复技能trellis continue 的任务续接实战指南 导读 本文以 EcoPaste 仓库中内置的 Agent桌面应用开发工具EcoPaste 项目的 Trellis 工作流续接指南Continue Current Task 命令全流程解析EcoPaste 项目的 Trellis 工作流续接指南Continue Current Task 命令全流程解析 导读 本文以仓库中 .opencode/c桌面应用EcoPaste 仓库 Trellis 工作流任务续接实战get_context.py 状态路由与分阶段恢复指南EcoPaste 仓库 Trellis 工作流任务续接实战get_context.py 状态路由与分阶段恢复指南 本指南讲解 EcoPaste 仓库内置的 T桌面应用上一篇20K Vocab Builder 提示词拆解3 步复刻 COCA 20K 词汇学习 GPT下一篇IPXWrapper终极指南3步让经典游戏在Windows 11上重获联机能力创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考