Trellis高级技巧如何通过workflow.md自定义你的AI协作流程【免费下载链接】TrellisThe best agent harness.项目地址: https://gitcode.com/gh_mirrors/trellis11/TrellisTrellis作为一款强大的AI协作框架允许用户通过workflow.md文件深度定制AI协作流程。本文将详细介绍如何通过修改这个核心配置文件打造符合个人或团队需求的AI工作流提升开发效率与协作质量。为什么选择workflow.md自定义流程在AI辅助开发的过程中标准化的流程往往无法满足所有团队的个性化需求。Trellis的workflow.md文件作为单一事实源Single Source of Truth集中管理着开发阶段、任务创建规则和技能路由策略。通过自定义此文件你可以适配团队习惯调整流程以匹配现有开发方法论优化特定场景为复杂任务添加自定义审查阶段简化工作流去除不必要的步骤提高效率扩展状态管理添加如in-review等自定义状态Trellis默认工作流示意图展示了从会话开始到任务完成的完整流程workflow.md文件结构解析workflow.md位于项目根目录下的.trellis/文件夹中主要包含以下关键部分1. 核心原则与系统概述文件开头定义了Trellis的核心开发原则如计划优先于编码、持久化所有内容等以及开发者身份、规范系统、任务系统和工作区系统的基本配置。2. 阶段索引Phase Index这是工作流定义的核心将开发过程分为三个主要阶段Phase 1: Plan计划需求分析、任务创建和研究Phase 2: Execute执行代码实现和质量检查Phase 3: Finish完成调试回顾、规范更新和提交每个阶段包含多个步骤如Phase 1包含任务创建(1.0)、需求探索(1.1)、研究(1.2)等子步骤。3. 工作流状态标签块以[workflow-state:STATUS]格式定义的标签块控制不同状态下AI的行为。例如[workflow-state:no_task]无活动任务时的提示[workflow-state:planning]规划阶段的指引[workflow-state:in_progress]执行阶段的工作流这些标签块的内容会被Trellis的钩子脚本解析并在AI交互过程中动态注入上下文。自定义工作流的实用技巧1. 修改现有阶段步骤要调整现有阶段的行为只需编辑对应阶段的描述。例如要修改Phase 2.2的质量检查流程找到## Phase 2: Execute部分编辑2.2 Quality check小节的内容确保相关的[workflow-state:in_progress]标签块内容同步更新2. 添加自定义状态若要添加如代码审查中这样的自定义状态在## Phase Index部分添加新的状态标签块[workflow-state:in-review] 代码正在审查中请等待团队反馈。审查期间可进行相关文档完善。 [/workflow-state:in-review]在task.json中添加生命周期钩子以设置此状态{ hooks: { after_finish: [ your-script-to-set-in-review-status ] } }3. 调整技能路由规则在### Active Task Routing部分可以修改不同AI平台的技能路由策略。例如为特定平台添加自定义技能[Claude Code, Cursor, OpenCode] - 代码优化需求 - trellis-optimize - 文档生成需求 - trellis-document [/Claude Code, Cursor, OpenCode]4. 添加自定义生命周期钩子通过修改task.json中的hooks字段可以添加自定义生命周期钩子{ hooks: { after_archive: [ python3 ./.trellis/scripts/send-notification.py ] } }支持的事件包括after_create、after_start、after_finish和after_archive。自定义示例添加代码审查阶段让我们通过一个实际示例了解如何在现有工作流中添加一个代码审查阶段修改Phase Index在Phase 2和Phase 3之间添加新阶段Phase 2: Execute → implement only after task status is in_progress Phase 2.5: Review → code review and feedback Phase 3: Finish → verify, update spec, commit, and wrap up添加新的状态标签块[workflow-state:in-review] 进入代码审查阶段。请将代码提交至审查分支并通知团队成员进行审查。 审查期间应 - 响应审查意见并进行修改 - 更新相关文档 - 准备审查通过后的合并计划 [/workflow-state:in-review]更新任务状态流转逻辑确保AI能够正确识别和进入新状态。最佳实践与注意事项保持兼容性修改时注意保持与Trellis核心脚本的兼容性特别是inject-workflow-state.py解析逻辑同步更新文档修改工作流后确保同步更新相关文档使团队成员了解新流程测试变更在正式使用前通过测试任务验证新工作流的正确性版本控制对workflow.md的修改应纳入版本控制便于追踪变更和回滚遵循格式约束自定义状态名只能包含字母、数字、下划线和连字符[A-Za-z0-9_-]总结通过workflow.md自定义Trellis工作流是提升AI协作效率的关键技巧。无论是调整现有阶段、添加自定义状态还是修改技能路由规则都能让AI工具更好地适应你的团队需求。记住最佳工作流是不断演进的建议定期回顾和优化你的workflow.md文件以适应项目和团队的发展。要查看完整的工作流定义请参考项目中的packages/cli/src/templates/trellis/workflow.md文件。【免费下载链接】TrellisThe best agent harness.项目地址: https://gitcode.com/gh_mirrors/trellis11/Trellis创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
