Trellis任务管理完全指南:从创建到归档的全生命周期掌控 Trellis任务管理完全指南从创建到归档的全生命周期掌控【免费下载链接】TrellisThe best agent harness.项目地址: https://gitcode.com/gh_mirrors/trellis11/TrellisTrellis是一款强大的任务管理工具能够帮助开发者高效地管理项目任务从创建到归档的全生命周期都能得到完美掌控。本文将为您详细介绍Trellis任务管理的各个环节让您轻松上手这款终极任务管理工具。为什么选择Trellis进行任务管理在软件开发过程中有效的任务管理至关重要。Trellis作为最佳的代理管理工具提供了一套完整的任务管理系统帮助团队和个人更好地规划、执行和跟踪任务。它的核心优势在于完整的任务生命周期从任务创建到归档Trellis提供了一站式解决方案自动化工作流通过子代理系统自动分配和执行任务丰富的上下文管理自动加载项目上下文包括工作流规则、活动任务、git状态等灵活的定制化支持自定义工作流和任务状态满足不同项目需求Trellis任务管理演示展示了Trellis如何加载会话并读取项目上下文Trellis任务管理核心概念任务系统概述Trellis的任务系统是其核心功能每个任务都有自己的目录位于.trellis/tasks/{MM-DD-name}/下包含以下关键文件task.json任务元数据prd.md需求文档可选的design.md设计文档可选的implement.md实施计划可选的research/研究资料目录implement.jsonl和check.jsonl子代理上下文清单工作流概览Trellis的工作流分为三个主要阶段计划(Plan)、执行(Execute)和完成(Finish)。每个阶段都有明确的目标和步骤确保任务有序进行。Trellis工作流程图展示了从会话开始到任务完成的完整流程包括自动注入项目上下文和按需调度独立子代理任务创建开启高效工作的第一步创建任务是使用Trellis进行任务管理的起点。通过以下命令可以快速创建一个新任务python3 ./.trellis/scripts/task.py create task title --slug name注意--slug是人类可读的名称不需要包含MM-DD-日期前缀Trellis会自动添加。对于复杂项目Trellis支持创建任务树结构即父任务和子任务。先创建父任务然后使用--parent参数创建子任务python3 ./.trellis/scripts/task.py create child task title --slug child-name --parent parent-dir任务创建后状态会被设置为planning并自动生成默认的prd.md文件。此时工作流状态会切换到[workflow-state:planning]提示AI保持在规划阶段。任务规划为成功执行奠定基础规划阶段是确保任务顺利完成的关键包括需求探索、研究和上下文配置等步骤。需求探索使用trellis-brainstorm技能与用户交互式地探索需求主要工作包括一次提出一个问题优先研究而非直接询问用户提供选项而非开放式问题在每次用户回答后立即更新prd.md当可交付成果可以独立验证时将大范围拆分为父任务和子任务保持prd.md专注于需求和验收标准对于复杂任务在开始实施前生成design.md和implement.mdTrellis用例展示如何在Markdown中定义标准Trellis会将其注入到每个AI会话中研究研究可以在需求探索的任何时候进行不仅限于本地代码还可以使用任何可用工具MCP服务器、技能、网络搜索等查找外部信息。研究结果必须写入文件保存在{TASK_DIR}/research/目录下而不是仅留在聊天记录中。上下文配置对于支持子代理的平台需要整理implement.jsonl和check.jsonl文件以便第二阶段的子代理获得正确的规范和研究上下文。这些文件在任务创建时已经生成初始包含一个自描述的_example行您需要填充实际内容。使用以下命令可以查看可用的规范包python3 ./.trellis/scripts/get_context.py --mode packages使用以下命令添加上下文条目python3 ./.trellis/scripts/task.py add-context $TASK_DIR implement path reason python3 ./.trellis/scripts/task.py add-context $TASK_DIR check path reason任务激活准备开始执行完成规划后通过以下命令将任务状态切换为in_progresspython3 ./.trellis/scripts/task.py start task-dir对于轻量级任务prd.md可能就足够了。但对于复杂任务在启动前必须存在并审查prd.md、design.md和implement.md。在支持子代理的平台上implement.jsonl和check.jsonl在启动前必须都有真正的精选条目。任务激活后工作流状态会自动切换到[workflow-state:in_progress]接下来将进入执行阶段。任务执行实现计划并确保质量执行阶段的目标是将经过审查的规划成果转化为通过质量检查的代码主要包括实施和质量检查两个步骤。实施根据不同的平台Trellis提供了不同的实施方式。对于支持子代理的平台可以生成实施子代理Agent type: trellis-implement Task description: Implement the reviewed task artifacts, consulting materials under {TASK_DIR}/research/; finish by running project lint and type-check对于内联模式平台如codex-inline, Kilo等则直接在主会话中实施加载trellis-before-dev技能以读取项目指南阅读{TASK_DIR}/prd.md然后是design.md如果存在然后是implement.md如果存在查阅{TASK_DIR}/research/下的资料根据审查过的工件实施代码运行项目 lint 和类型检查质量检查实施完成后需要进行质量检查。对于支持子代理的平台可以生成检查子代理Agent type: trellis-check Task description: Review all code changes against specs and task artifacts; fix any findings directly; ensure lint and type-check pass对于内联模式平台则加载trellis-check技能进行验证规范合规性lint / 类型检查 / 测试跨层一致性当更改跨越多层时如果发现问题修复后重新检查直到通过。任务并行处理提高团队效率Trellis支持并行处理多个任务使用/parallel命令可以在隔离的工作树中生成多个会话$ /parallel Starting parallel mode... [1] Worker: feature/auth-system [2] Worker: feature/dashboard-ui [3] Worker: feature/api-endpoints All workers runningTrellis并行工作用例展示如何同时处理多个功能并在准备就绪时合并并行处理可以大大提高团队效率特别是在处理相互独立的功能模块时。任务完成确保质量并记录成果完成阶段的目标是确保代码质量捕获经验教训记录工作成果。调试回顾如果任务涉及反复调试同一问题被多次修复加载trellis-break-loop技能来分类根本原因解释早期修复失败的原因提出预防措施规范更新加载trellis-update-spec技能审查此任务是否产生了值得记录的新知识新发现的模式或约定遇到的陷阱新的技术决策相应地更新.trellis/spec/下的文档。提交更改在完成任务后需要提交更改。Trellis建议遵循以下步骤检查脏状态git status --porcelain从最近的历史中学习提交风格git log --oneline -5将脏文件分为两组AI编辑的文件和未识别的文件制定提交计划按逻辑单元分组提交呈现计划并请求确认根据确认执行提交任务归档完成所有工作后使用以下命令将任务归档python3 ./.trellis/scripts/task.py archive name归档会将任务状态设置为completed并将目录移动到archive/{year-month}/下同时删除任何仍然指向已归档任务的运行时会话文件。自定义工作流适应项目需求Trellis允许定义自定义工作流通过斜线命令为特定任务准备AI# .claude/commands/before-frontend-dev.md Load frontend development context: 1. Read component guidelines 2. Check recent changes 3. Load test patterns 4. Review shared hooks运行命令加载上下文$ /before-frontend-dev Loading component guidelines... Checking recent changes... Loading test patterns... Frontend context loaded!Trellis自定义工作流用例展示如何定义斜线命令为特定任务准备AI总结Trellis任务管理的最佳实践Trellis提供了一个全面的任务管理系统从创建到归档的全生命周期都能得到有效掌控。以下是一些最佳实践计划先行在开始编码前先弄清楚要做什么规范注入通过钩子/技能注入指南而不是从内存中回忆持久化一切研究、决策和经验都要写入文件增量开发一次一个任务捕获学习每个任务后回顾并将新知识写回规范通过遵循这些最佳实践和本文介绍的步骤您将能够充分利用Trellis的强大功能提高任务管理效率确保项目顺利进行。要开始使用Trellis只需克隆仓库并按照文档进行初始化git clone https://gitcode.com/gh_mirrors/trellis11/Trellis cd Trellis # 按照文档进行初始化立即开始使用Trellis体验高效任务管理的乐趣【免费下载链接】TrellisThe best agent harness.项目地址: https://gitcode.com/gh_mirrors/trellis11/Trellis创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考