ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Trellis 技能体系实战指南:Skills、Commands、Prompts 与 Workflows 的区别、结构与本地定制方法

Trellis 技能体系实战指南:Skills、Commands、Prompts 与 Workflows 的区别、结构与本地定制方法 桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载导读Trellis 将告诉 AI 如何进入工作流的能力封装为四类文本入口skill、command、prompt 与 workflow。不同 AI 平台对这些入口有不同的命名与存放目录但其核心目的完全一致——当用户表达某种意图时指导 AI 进入 Trellis 流程。本文以 Trellis 官方参考文档skills-and-commands.md为骨架结合 EcoPaste 仓库中实际生成的.kiro/skills/、.claude/、.agents/skills/等目录系统讲解四类入口的概念差异、平台路径矩阵、目录结构规范、修改原则以及如何区分内置捆绑技能与项目本地技能这一最关键的定制决策帮助你安全、可持久地定制自己项目中的 AI 行为。四类文本入口的概念差异Skills、Commands、Prompts 与 Workflows 是用户与 Trellis 交互的文本入口。虽然不同平台叫法各异但它们的本质都是当用户表达某种意图时告诉 AI 如何进入 Trellis 流程的文本定义。四者按触发模式与适用场景区分如下类型触发模式最佳用途skillAI 自动匹配或用户显式提及长期能力、工作流规则、修改指南command用户显式调用清晰的操作入口如 continue、finish-workprompt用户显式调用或平台选择与 command 类似但以平台提示词格式呈现workflow用户显式选择或平台自动匹配在无子代理/hook 时引导主会话Trellis 的工作流技能workflow skills通常共享同一套语义集合brainstorm、before-dev、check、update-spec、break-loop。像trellis-meta这样的多文件内置技能则使用分层引用layered references——入口文件只负责触发与路由详细内容拆散到references/子目录中按需读取。这一语义集合在 EcoPaste 仓库中得到了完整印证.kiro/skills/、.claude/skills/、.agents/skills/等平台目录下均能观察到trellis-brainstorm、trellis-before-dev、trellis-check、trellis-update-spec、trellis-break-loop等成套技能且每个技能都采用SKILL.mdreferences/的分层结构。各平台通用入口路径矩阵不同 AI 平台存放技能与命令的目录约定不同。Trellis 官方参考文档给出了各平台通用入口的对照表平台常用入口Claude Code.claude/skills/、.claude/commands/Cursor.cursor/skills/、.cursor/commands/OpenCode.opencode/skills/、.opencode/commands/Codex.agents/skills/、.codex/skills/Kilo.kilocode/skills/、.kilocode/workflows/Kiro.kiro/skills/Gemini CLI.agents/skills/、.gemini/commands/Antigravity.agent/skills/、.agent/workflows/Devin.devin/skills/、.devin/workflows/Qoder.qoder/skills/、.qoder/commands/CodeBuddy.codebuddy/skills/、.codebuddy/commands/GitHub Copilot.github/skills/、.github/prompts/Factory Droid.factory/skills/、.factory/commands/Pi Agent.pi/skills/Reasonix.reasonix/skills/ZCode.agents/skills/、.zcode/commands/重要提示在具体用户项目中应以trellis init实际生成的文件为准路径表仅作参考。因为平台生态会演进且用户项目可能已被自行定制过。EcoPaste 仓库正是一个典型实例——它同时存在.kiro/skills/、.claude/skills/、.cursor/skills/、.opencode/skills/、.agents/skills/、.github/skills/多套平台目录其中每个目录下都自动部署了成套的 Trellis 内置技能无需手工接线。Skill 结构入口文件短引用内容长一个普通的 skill 是一个目录trellis-meta/ ├── SKILL.md └── references/SKILL.md需要告诉 AI 三件事何时使用该 skill触发条件当前任务应先读取哪份 reference哪些事情不要做禁止事项。而references/目录承载更长的说明避免入口文件塞满全部内容。以 trellis-meta 的 SKILL.md 为例其 frontmatter 的description用一段长文本精确声明了适用场景理解并定制用户项目内的本地 Trellis 架构在修改.trellis及平台 hooks、settings、agents、skills、commands、prompts、workflows……时使用正文则给出如何使用的阅读顺序——先读references/local-architecture/overview.md建立系统模型再按需求分支读取对应主题文档——并在文末以 Do Not 清单明确禁止事项如不要修改全局 npm 安装目录、不要直接手工编辑~/.trellis/channels/下的事件日志等。实际案例.claude/skills/trellis-before-dev/SKILL.md展示了标准写法。它的 frontmatter 中description精确描述了触发条件在开始实现前发现并注入.trellis/spec/中的项目级编码规范……在开始新编码任务、写任何代码之前、切换包、或需要刷新项目约定时使用正文则是一步步的命令式执行清单读取任务产物 → 运行get_context.py --mode packages→ 读取 spec 索引与共享指南。这正体现了描述写得足够具体才能正确触发的原则。Command / Prompt / Workflow 结构单文件入口Commands、prompts 和 workflows 通常是单文件。它们的内容应包含何时使用应读取哪些.trellis/文件应运行哪些脚本完成后如何汇报。关键约束它们不应存储任务状态——任务状态属于.trellis/tasks/和.trellis/.runtime/。EcoPaste 仓库中的实际示例是.claude/commands/trellis/continue.md与.claude/commands/trellis/finish-work.mdcontinue.md是继续当前任务入口分四步引导 AI运行python3 ./.trellis/scripts/get_context.py确认当前任务与 git 状态 → 以--mode phase加载 Phase Index → 依据任务status字段路由到具体阶段 → 以--mode phase --step X.X --platform claude加载具体步骤。文件末尾明确声明本命令只是入口规范指引在.trellis/workflow.md——这正是command 不应重复工作流规则而应引用工作流文件的实践。finish-work.md是结束工作入口同样明确列出要运行的脚本get_context.py --mode record、git status --porcelain、task.py archive、add_session.py并规定了汇报方式归档任务、记录会话日志、输出最终 git log 顺序。本地修改场景该改哪里当用户提出不同的 AI 行为变更需求时Trellis 官方参考文档给出了清晰的定位指引用户需求修改位置修改 AI 自动触发规则对应 skill 的 frontmatter description修改用户命令行为对应的 command/prompt/workflow 文件新增项目本地 skill平台 skill 目录或共享的.agents/skills/让多个平台共享同一能力在每个平台 skill 目录写等价 skill或在支持共享层的平台使用.agents/skills/修改 finish/continue 入口平台 commands/prompts/workflows这条共享层思路在 EcoPaste 仓库中有直接体现.agents/skills/目录被 Codex 使用而仓库中.agents/skills/与.claude/skills/、.cursor/skills/等目录共存各自承载同一套 Trellis 内置技能同时.agents/skills/sync-zh-changelog/是一个典型的项目本地技能含SKILL.md、agents/openai.yaml、scripts/check_sync.py说明项目自有能力可以独立存在于共享层中。四条修改原则官方参考文档给出了四条必须遵守的修改原则保持入口文件简短引用承载长内容。这一点对trellis-meta这类多文件技能尤其重要。让触发描述足够具体。描述太宽泛会误触发太窄则可能不触发。反面示例就是helpful project skill这类含糊描述。保持跨平台语义一致。文件格式可以不同但行为描述应当匹配。把项目专属能力放进本地技能。不要把团队私有流程写入公开的trellis-meta。如果用户只是想让本地 AI 多知道一条项目规则通常的做法是创建项目本地技能或更新.trellis/spec/而不是去改动 Trellis 内置的工作流技能。深入捆绑技能 vs 项目本地技能的定制决策trellis-meta的定制姊妹文档 change-skills-or-commands.md 进一步把上述原则落地为动手前必须先分类的硬性要求。你在编辑任何一个技能前必须先判断它属于哪一类维度捆绑技能trellis-meta、trellis-spec-bootstrap、trellis-session-insight、trellis-channel项目本地技能事实来源source of truthTrellis CLI 仓库的packages/cli/src/templates/common/bundled-skills/name/用户项目自身分发方式由getBundledSkillTemplates()在trellis init/trellis update时自动分发到每个平台 skill 根目录由用户或其他技能创建永不被移动Hash 跟踪每个文件记录在.trellis/.template-hashes.json更新时提示冲突不被跟踪本地编辑允许但下次更新会被标记为 modified by user自由编辑正确的定制方式新建一个不同名字的项目本地技能来补充或取代捆绑技能直接编辑文件从源码结构看判定一个技能是否属于捆绑集最直接的方法是检查.trellis/.template-hashes.json中是否存在该文件的记录——有记录则是上游托管无记录则是项目本地。EcoPaste 仓库的.kiro/skills/、.claude/skills/等目录中大量存在的trellis-meta、trellis-spec-bootstrap、trellis-session-insight、trellis-channel即属于捆绑技能而.agents/skills/sync-zh-changelog/则属于项目本地技能。给项目本地技能命名时绝对不能与捆绑集合撞名trellis-meta、trellis-spec-bootstrap、trellis-session-insight、trellis-channel否则getBundledSkillTemplates()会在下一次更新时用模板覆盖掉你的本地副本。通用约定是以项目名做前缀例如acme-trellis-deploy、acme-trellis-onboarding。修改 Command / Prompt / Workflow 的要点显式入口command/prompt/workflow在编写时应声明四件事用户如何触发、要读取哪些.trellis/文件、要运行哪些脚本、完成后如何汇报。如果某个 command 只是在复述工作流规则更好的做法是让它引用/读取.trellis/workflow.md而不是维护一份流程副本——EcoPaste 仓库中.claude/commands/trellis/continue.md的结尾声明正是这一原则的官方示范完整工作流与分阶段步骤见.trellis/workflow.md本命令只是入口。操作注意事项Notes官方参考文档还列出了一组禁止项值得在定制前通读不要把各平台语法混进同一个文件不要只改一个平台入口却声称所有平台都支持——多平台项目需要在每个平台的技能目录中写入等价版本不要把长期工程规范藏在 command 里应写入.trellis/spec/不要手工编辑任何.{platform}/skills/目录下trellis-meta/、trellis-spec-bootstrap/、trellis-session-insight/、trellis-channel/内的文件并期待改动持久——它们是捆绑技能会被trellis update刷新。正确路径是要么向 Trellis 上游提交贡献编辑packages/cli/src/templates/common/bundled-skills/name/要么新增一个与之互补的项目本地技能当trellis update报告捆绑技能文件的 modified by you 冲突时只有在你愿意长期手工维护该分歧的前提下才选择keep否则接受覆盖并把意图以项目本地技能的形式重新落地。结语Skills、Commands、Prompts 与 Workflows 构成了 Trellis 与各 AI 平台交互的完整入口体系skill 面向 AI 自动触发的长期能力command/prompt/workflow 面向用户显式调用而 workflow 在无子代理/hook 的场景下承担引导主会话的职责。理解入口文件短、引用内容长的结构规范牢记触发描述要具体、跨平台语义要一致、项目能力走本地技能的修改原则再借助.trellis/.template-hashes.json正确区分捆绑技能与项目本地技能你就能在自己的项目中如同本仓库一样安全、可持久地定制 AI 的进入方式与行为规则。赞分享桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载相关推荐Trellis 技能与命令体系全解析Skills、Commands、Prompts、Workflows 的区别、结构与落地实践以 EcoPaste 仓库为例Trellis 技能与命令体系全解析Skills、Commands、Prompts、Workflows 的区别、结构与落地实践以 EcoPaste 仓库为例桌面应用在 EcoPaste 项目中自定义 Trellis 本地 Skills、Commands、Prompts 与 Workflows在 EcoPaste 项目中自定义 Trellis 本地 Skills、Commands、Prompts 与 Workflows 本篇技术指南以 Trellis桌面应用Trellis Skills、Commands、Prompts 与 Workflows 全解析平台文件设计与本地定制指南Trellis Skills、Commands、Prompts 与 Workflows 全解析平台文件设计与本地定制指南 在 Trellis 的本地架构中桌面应用上一篇零代码玩转ToolJet用户管理从注册到权限控制全攻略下一篇5分钟构建完美工具提示floating-ui从入门到精通指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表