mcpField
T
trellis-start

trellis-start

github.com/mindfold-aiAgent 工作流15.0k132 次安装4 周前更新
代码仓库

关于 trellis-start

trellis-start 是用于初始化 Trellis 开发会话的技能，面向编码 Agent。它汇总项目状态、工作流指引和后续操作，帮助恢复开发工作。

主要功能

  1. 01通过 get_context.py 加载会话状态
  2. 02查看工作流阶段与分类规则
  3. 03查找相关指南索引
  4. 04确定任务的下一步操作
  5. 05将工作路由至相关 Trellis 技能

适用场景

  1. 01恢复 Trellis 开发会话
  2. 02检查活动任务的阶段与状态
  3. 03在开始实现前查找指引

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/mindfold-ai/trellis --skill trellis-start

安装后在 Claude Code 中输入/trellis-start确认已加载。

详细介绍

启动会话

初始化 Trellis 管理的开发会话。此平台没有会话启动钩子，因此请按照以下步骤手动加载等效的精简上下文。

第 1 步：当前状态

身份、git 状态、当前任务、活跃任务、日志位置。

python3 ./.trellis/scripts/get_context.py

如果此输出包含以 Trellis update available: 开头的行，在概述会话上下文时请逐字复制完整行。不要缩短操作命令提示。

第 2 步：工作流概览

精简阶段索引、请求分流规则、规划产物约定，以及步骤详情命令。

python3 ./.trellis/scripts/get_context.py --mode phase

完整指南位于 .trellis/workflow.md（按需阅读）。

第 3 步：指南索引

发现程序包和规范层，然后阅读每个相关的索引文件。

python3 ./.trellis/scripts/get_context.py --mode packages
cat .trellis/spec/guides/index.md
cat .trellis/spec/<package>/<layer>/index.md   # for each relevant layer

索引文件会列出实际开始编码时需要阅读的具体指南文档。

第 4 步：决定下一步操作

从第 1 步了解当前任务和状态。检查任务目录：

  • 活跃任务状态为 planning，且不存在 prd.md → 阶段 1.1。加载 trellis-brainstorm 技能。
  • 活跃任务状态为 planning，且存在 prd.md → 继续阶段 1。轻量任务可以只编写 PRD；复杂任务需要 design.md 和 implement.md。在运行 task.py start 前，加载相关的阶段 1 步骤详情。
  • 活跃任务状态为 in_progress → 阶段 2 的步骤 2.1。加载步骤详情： 
    python3 ./.trellis/scripts/get_context.py --mode phase --step 2.1 --platform codex
  • 没有活跃任务 → 先进行分类。对于简单对话 / 小型任务，只询问本轮是否应创建 Trellis 任务。对于复杂工作，询问是否可以创建 Trellis 任务并进入规划阶段。如果用户拒绝，本次会话跳过 Trellis。

技能路由（快速参考）

用户意图技能
新功能 / 需求不明确trellis-brainstorm
即将编写代码trellis-before-dev
编码完成 / 质量检查trellis-check
陷入困境 / 多次修复同一错误trellis-break-loop
有值得记录的经验trellis-update-spec

完整规则和避免自我合理化表格见 .trellis/workflow.md。

评论

支持 Markdown