桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载导读本文以仓库内.agents/skills/trellis-meta/references/local-architecture/workflow.md文档为主体深入讲解 Trellis 本地工作流系统中.trellis/workflow.md这一核心文件的三大职责——阶段Phase定义、技能路由Skill Routing与 workflow-state 提示块注入并结合 trellis-meta 技能文档中的源码级细节给出完整的本地定制操作指南。读完本文你将掌握.trellis/workflow.md的内部结构与全部修改入口能够在自己的项目中精准调整 AI 的任务推进流程、任务创建策略与收尾方式。一、系统定位为什么一个文件就够了在 Trellis 本地工作流的设计中.trellis/workflow.md是项目内部的工作流事实来源source of truth。官方文档给出的一个关键论断是An AI does not need Trellis source code to understand how the current project should move tasks forward; this file is enough.也就是说AI 不需要阅读 Trellis 的 CLI 源码只需要读取项目内的.trellis/workflow.md就能理解当前项目应当如何推进任务。这使workflow.md成为AI 行为契约的语义中心修改本地 AI 行为首先改这个文件。本仓库虽然没有生成.trellis/目录trellis init尚未在本仓库执行但完整承载了这套系统的设计文档入口位于 本地架构总览 与 工作流文档。该总览同时说明了 Trellis 在用户项目内提供的三层本地系统模型Workflow 层.trellis/workflow.md定义阶段、路由、下一步动作与提示块持久化层.trellis/tasks/、.trellis/spec/、.trellis/workspace/存储任务、规格与会话记忆平台集成层各平台目录中的 hooks、settings、agents、skills、commands、prompts 与 workflows将 Trellis 工作流连接到不同的 AI 工具。三层都在用户项目内部AI 可以直接读取和修改这也正是本地定制模式成立的前提。二、workflow.md 的三大职责文档将.trellis/workflow.md的职责精炼为三条职责说明1. 解释工作流阶段定义 Plan、Execute、Finish 三个阶段的含义与推进方式2. 定义技能路由规定用户表达某种意图时AI 应使用哪个技能skill或代理agent3. 提供 workflow-state 提示块hooks 可以将当前状态对应的提示块注入到对话上下文中这三条职责共同决定了 AI 在无事可做、规划中、实施中、已完成四种状态下分别应该做什么。后续所有定制操作也全部围绕这三条展开。三、阶段模型Plan → Execute → Finishworkflow.md内置了如下三阶段模型Phase 1: Plan - clarify what to build, produce prd.md and required research Phase 2: Execute - implement against the PRD and specs, then check Phase 3: Finish - final verification, preserve lessons, and wrap upPhase 1规划澄清要构建什么产出prd.md与所需的研究材料Phase 2执行依据 PRD 与规格实施然后进行检查checkPhase 3收尾最终验证、沉淀经验教训并收尾。每个阶段内部包含编号步骤例如1.3 Configure context。文档特别强调了一个容易误解的点These numbers are not runtime fields intask.json; they are workflow structure for AI and humans to read.即阶段编号是给人机和 AI 阅读的工作流结构标记不是task.json中的运行时字段。任务的实际进度判定依据见 任务系统文档主要由status字段、工件是否存在prd.md、可选的design.md/implement.md、JSONL 上下文是否配置以及workflow.md中的阶段描述共同决定。AI 不应把阶段编号当作任务状态来对待。收尾阶段有明确的内部分工定制收尾流程时务必知晓Phase 3.4AI 驱动的代码提交批量、需用户确认Phase 3.5/finish-work归档任务并记录会话。/finish-work在工作树不干净dirty时拒绝运行。四、技能路由Skill Routingworkflow.md按平台能力将路由分为两类支持子代理sub-agent的平台默认派发trellis-implement负责实施、trellis-check负责检查不支持子代理的平台主会话直接读取trellis-before-dev等技能然后自行执行。文档给出的修改纪律是When changing local AI behavior, update the routing descriptions inworkflow.mdfirst, then check whether the corresponding platform skill, command, or agent files need to stay in sync.即先改workflow.md中的路由描述再检查对应的平台 skill / command / agent 文件是否需要同步。这与 本地定制总览 中本地文件优先级的思路一致——workflow.md属于工作流层最高优先级平台集成文件次之修改时遵循先读事实来源、窄幅修改、同步语义的操作顺序。五、workflow-state 提示块状态注入机制workflow.md底部可以存放形如下文的状态块[workflow-state:no_task] ... [/workflow-state:no_task]hooks 根据当前任务状态选择对应的块并注入到对话中。文档列出的常见状态如下状态含义no_task当前会话没有活动任务planning任务仍处于需求、研究或上下文配置阶段in_progress任务已进入实施与检查阶段completed任务已完成等待收尾或归档上下文注入文档 进一步解释了它在注入链路中的位置workflow-state是一种围绕每一轮用户输入注入的轻量提示lightweight hint基于当前任务状态从.trellis/workflow.md中选择no_task/planning/in_progress/completed等块。若想改变某状态下 AI 下一步该做什么应先编辑对应的状态块。值得特别注意的语法约束来自 工作流定制文档保持开闭标签的 STATUS 字符串完全一致[workflow-state:foo]…[/workflow-state:foo]STATUS 不匹配的块会被静默丢弃。同文档还明确workflow-state 的改动只需编辑.trellis/workflow.md中的[workflow-state:STATUS]块因为hook 是纯解析器parser-only——它原样读取你写进块里的内容不附带任何回退文本。六、本地修改模式常见需求与编辑点文档用一张表格给出了最常见的修改需求与对应的编辑位置这是定制工作流最实用的速查表目标编辑点添加一个阶段更新阶段索引Phase Index、阶段正文、路由与状态块修改任务创建策略更新no_task状态块与 Phase 1 描述修改默认的实施/检查路径更新 Phase 2 与技能路由修改收尾流程更新 Phase 3 与finish-work相关描述。注意当前分工Phase 3.4 AI 驱动代码提交批量、用户确认Phase 3.5 /finish-work归档 记录会话工作树脏时/finish-work拒绝运行修改平台差异按平台分组更新路由描述与之配套的规范修改步骤同样来自 工作流定制文档共五步在.trellis/workflow.md中找到相关小节修改规则时保留明确的触发条件与下一步动作新增或重命名 skill / agent 时同步平台目录中对应的文件workflow-state 的改动只需编辑.trellis/workflow.md中的[workflow-state:STATUS]块语法约束见上文修改完成后让 AI 重新读取.trellis/workflow.md不要沿用旧会话中的规则。文档同时给出收尾提醒编辑后平台入口文件可能仍保留旧描述因此也要检查它们——这与下一节与平台文件的关系的核心思想完全一致。七、与平台文件的关系语义中心 vs 平台入口workflow.md是本地工作流的语义中心但每个平台还可以拥有自己的入口文件skills如trellis-brainstorm、trellis-checkcommands / prompts / workflows如 continue、finish-workhooks如 session-start 或 workflow-state 注入。文档给出的判断标准是If onlyworkflow.mdchanges, platform entry files may still contain old language. When the user wants to change what the AI actually does, also inspect the relevant platform directory.也就是说只改workflow.md时平台入口文件可能还写着旧文案。当用户真正想改变AI 实际做什么时必须同时检查相关平台目录。从 hooks 定制文档 可以看到典型入口.claude/settings.json、.codex/hooks.json、.cursor/hooks.json等负责注册 hookhook 脚本负责行为二者必须一并检查。八、进阶/trellis:continue 路由表与自定义状态这是工作流文档之外、但同属工作流定制主题的高价值内容同样出自 工作流定制文档。/trellis:continue通过结合task.json.status与任务目录内工件的存在情况决定下一步加载哪个阶段步骤status工件状态恢复位置planningprd.md缺失Phase 1.1加载trellis-brainstormplanning轻量任务且prd.md完成请求开始评审然后运行task.py startplanning复杂任务缺少design.md或implement.md补全缺失的规划工件planning复杂任务已有prd.md、design.md、implement.md请求开始评审然后运行task.py startin_progress会话历史中无实施内容Phase 2.1trellis-implementin_progress实施完成、未运行过trellis-checkPhase 2.2trellis-checkin_progress检查通过Phase 3.3规格更新→ 3.4提交completed任务仍在活动树中Phase 3.5运行/trellis:finish-work归档该路由表的映射关系固定在命令本身。若你为任务系统增加自定义状态例如in-review需要做两件事在.trellis/workflow.md中添加[workflow-state:in-review]块供逐轮面包屑提示使用扩展/trellis:continue的路由表——通常编辑.{platform}/commands/trellis/continue.md或等价文件新增一行决定从何处恢复。文档特别警告若缺少路由条目/trellis:continue会落入默认分支用户不会落在你预期的步骤上。九、实战示例两个典型定制场景示例一放宽任务创建要求若要改变什么情况下可以跳过任务创建通常编辑[workflow-state:no_task][workflow-state:no_task] Task is not required when the answer is a one-reply explanation, no files are changed, and no research is needed. [/workflow-state:no_task]若正式的 Phase 1 流程也需要同步调整则同时修改 Phase 1 小节对应上文的修改任务创建策略编辑点。示例二单一平台不使用子代理如果只想让某一个平台避免使用子代理应先确认该平台在workflow.md中是否有独立分组只修改该平台分组的 Phase 2 路由而不是删除所有平台上的trellis-implement/trellis-check指令。这种窄幅修改思路与 本地定制总览 强调的只编辑与请求相关的文件完全一致。十、与其他本地文件的关系阅读路径速查workflow.md不是孤立的文件它与 Trellis 本地架构中的其他文件共同工作。文档所在的本地架构目录给出了清晰的阅读路径想了解trellis init生成了哪些文件 → generated-files.md想修改阶段、路由或下一步动作 → workflow.md想修改任务模型、JSONL 上下文或活动任务行为 → task-system.md想修改编码规范的注入 → spec-system.md想了解日志与跨会话记忆 → workspace-memory.md想修改 hooks 或子代理上下文加载 → context-injection.md。其中generated-files.md 给出的.trellis/目录结构可作为理解workflow.md所处位置的全景图.trellis/ ├── workflow.md # 本地工作流文档与 AI 路由规则可编辑 ├── config.yaml # 项目配置、hooks、包配置、日志行数限制等可编辑 ├── .developer # 当前开发者身份谨慎编辑 ├── .version # Trellis 版本记录不可手工编辑 ├── .template-hashes.json # 模板哈希记录不可手工写入业务规则 ├── .runtime/ # 运行时状态自动写入 ├── scripts/ # 本地运行时脚本谨慎编辑 ├── spec/ # 项目规格可编辑 ├── tasks/ # 任务材料与研究工件可编辑 └── workspace/ # 会话记录可编辑十一、实践清单定制 workflow.md 时的检查要点综合工作流文档与其配套定制文档落地一次工作流定制时应依次完成先读后改读取.trellis/workflow.md、.trellis/config.yaml、相关平台目录及当前任务的task.json/prd.md不要凭记忆编辑定位小节在workflow.md中找到 Phase Index、阶段正文、Skill Routing 表或[workflow-state:STATUS]块保持结构约束状态块开闭标签 STATUS 必须一致不一致会被静默丢弃规则中保留明确的触发条件与下一步动作同步平台文件新增/重命名 skill/agent 时同步平台目录只改workflow.md后要检查平台入口是否残留旧文案让 AI 重新读取修改完成后要求 AI 重新读取.trellis/workflow.md禁止沿用旧会话规则只改本地项目编辑项目内生成的文件不修改全局 npm 安装目录、node_modules/mindfoldhq/trellis或 Trellis 上游源码——除非用户明确表示要提交 PR 或 fork。按照这一清单操作.trellis/workflow.md就能始终充当项目内AI 行为事实来源的角色让阶段推进、技能派发与状态提示三者保持长期一致。赞分享桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载相关推荐Quickemu 快速指南两条命令创建并启动 macOS、Windows、Linux 虚拟机Quickemu 快速指南两条命令创建并启动 macOS、Windows、Linux 虚拟机 想在 Linux 主机上跑一个 macOS 测试环境传统做法要桌面应用lowcode-engine code-generator 的 React 出码示例工程ice.js Lite 脚手架结构、condition 字面量处理与测试基线详解lowcode engine code generator 的 React 出码示例工程ice.js Lite 脚手架结构、condition 字面量处理与测桌面应用洛雪音乐音源完整配置教程3步解锁全网高品质音乐洛雪音乐音源完整配置教程3步解锁全网高品质音乐 你是否曾因为一首歌在不同音乐平台间切换而烦恼是否渴望获得更高品质的音乐体验却不知从何入手洛雪音乐音源项目为桌面应用上一篇Caffe2性能测试报告如何压榨GPU算力提升训练速度下一篇React Native FastImage终极图片裁剪指南7种ResizeMode与样式技巧创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考