| name | trellis-meta |
| description | 理解并自定义用户项目内的本地 Trellis 架构。修改 trellis init 生成的 .trellis 以及平台 hooks、settings、agents、skills、commands、prompts 或 workflows 时使用。 |
Trellis Meta
此 skill 面向已经在项目中运行 trellis init 的本地 Trellis 用户。读取后，AI 应理解该用户项目内的 Trellis 架构、运行模型和自定义入口点，然后按用户请求修改生成的 .trellis/ 和平台目录文件。
默认操作范围是用户项目中的本地文件：
.trellis/：workflow、config、tasks、spec、workspace、scripts 和 runtime state。- 平台目录：
.claude/、.codex/、.cursor/、.opencode/、.kiro/、.gemini/、.qoder/、.codebuddy/、.github/、.factory/、.pi/、.kilocode/、.agent/、.windsurf/ 以及类似目录。
- 共享 skill layer：
.agents/skills/。
不要假设用户拥有 Trellis source repository。不要默认修改全局 npm install 目录或 node_modules。
如何使用
- 先读取
references/local-architecture/overview.md，建立本地 Trellis 系统模型。
- 如果请求涉及特定 AI 工具，读取
references/platform-files/platform-map.md 和相关平台文件说明。
- 如果用户想改变行为，读取
references/customize-local/overview.md，然后打开具体自定义主题。
- 编辑前，读取用户项目中的实际文件，并将本地内容视为权威。
参考
本地架构
references/local-architecture/overview.md：三层本地 Trellis 架构和自定义原则。references/local-architecture/generated-files.md：trellis init 生成的文件及其自定义边界。references/local-architecture/workflow.md：.trellis/workflow.md 中的 phases、routing 和 workflow-state blocks。references/local-architecture/task-system.md：Task directories、active tasks、JSONL context 和 task runtime。references/local-architecture/spec-system.md：.trellis/spec/ 的组织和注入方式。references/local-architecture/workspace-memory.md：.trellis/workspace/、journals 和 cross-session memory。references/local-architecture/context-injection.md：Hooks、sub-agent preludes 和 context injection paths。
平台文件
references/platform-files/overview.md：共享 .trellis/ 文件与平台目录的关系。references/platform-files/platform-map.md：skills、agents、hooks 和 extensions 的平台目录与路径。references/platform-files/hooks-and-settings.md：settings/config files、hooks、plugins 和 extensions 如何连接到 Trellis。references/platform-files/agents.md：trellis-research、trellis-implement 和 trellis-check 的本地文件职责。references/platform-files/skills-and-commands.md：skills、commands、prompts 和 workflows 的区别，以及如何修改它们。
本地自定义
references/customize-local/overview.md：为用户请求选择正确的本地自定义入口点。references/customize-local/change-workflow.md：修改 phases、routing、next actions 和 workflow-state。references/customize-local/change-task-lifecycle.md：修改 task creation、status、archive behavior 和 hooks。references/customize-local/change-context-loading.md：修改 tasks、specs、journals 和 hook context 的加载方式。references/customize-local/change-hooks.md：修改平台 hooks、settings 和 shell session bridges。references/customize-local/change-agents.md：修改 research、implement 和 check agent 行为。references/customize-local/change-skills-or-commands.md：添加或修改本地 skills、commands、prompts 和 workflows。references/customize-local/change-spec-structure.md：调整 .trellis/spec/ 下的项目 spec 结构。references/customize-local/add-project-local-conventions.md：将团队规则放入项目本地 specs 或 local skills。
当前规则
.trellis/workflow.md 是本地 workflow 事实来源。.trellis/config.yaml 是项目级 Trellis 配置和 task hook 配置入口。.trellis/spec/ 存储用户项目特定的编码约定和设计约束。.trellis/tasks/ 存储 task PRDs、technical notes、research files 和 JSONL context。.trellis/workspace/ 存储 developer journals 和 cross-session memory。- Platform settings/config files 决定哪些 hooks、agents、skills、commands、prompts 和 workflows 实际运行。
.trellis/.template-hashes.json 和 .trellis/.runtime/ 是 management/runtime state files。编辑前确认必要性。
不要
- 不要把 Trellis upstream source code 当作本地自定义的默认目标。
- 不要通过修改全局 npm install 目录或
node_modules/@mindfoldhq/trellis 来实现项目需求。
- 不要用默认 templates 覆盖用户已修改的本地文件。
- 不要把团队私有项目规则放入 public
trellis-meta；项目规则应放在 .trellis/spec/ 或 project-local skill 中。
- 不要把已移除的历史机制描述为当前 Trellis 行为。
