新闻详情

新闻详情

首页 / 资讯中心 / 详情

EcoPaste 项目 Trellis Spec 结构定制指南:修改 `.trellis/spec/` 与 `config.yaml` 的完整操作手册

发布时间:2026/9/29 6:04:02来源:尧图网络
EcoPaste 项目 Trellis Spec 结构定制指南:修改 `.trellis/spec/` 与 `config.yaml` 的完整操作手册
桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载导读本指南讲解如何在 EcoPaste 这类由 Trellis 管理工作流的项目中调整 AI 所遵循的工程约定包括新增 spec 分层如 backend/frontend/docs/test 或某个 monorepo 包专属的 spec 层、维护共享思考指南guides、修改 monorepo 包映射与默认包、控制 spec 扫描范围以及让具体任务在implement.jsonl/check.jsonl中引用新 spec。读完本文你将掌握.trellis/spec/与.trellis/config.yaml两处配置的完整改动流程、配套 Python CLI 命令以及改动后的验证与清理方法。文中所有文件路径均以仓库根目录为起点与 EcoPaste 仓库内实际存在的.trellis/结构一一对应。前置阅读改动前必读的四类文件在动手修改 spec 结构前建议先通读以下四类内容理解 Trellis 的加载与注入机制文件/目录阅读目的.trellis/config.yaml项目级 Trellis 配置入口monorepo 包映射、默认包、spec_scope等本次要改的核心键.trellis/spec/现有 spec 层的组织方式新增层时参照其index.md与指导文件的结构.trellis/workflow.md规划产物planning artifact指引与 Phase 3.3 说明新增 spec 后如何在阶段流程中被使用当前任务的implement.jsonl/check.jsonl任务上下文引用的现有 spec 路径改结构前必须核对在 EcoPaste 仓库中.trellis/spec/采用按包/分层的真实结构可作为新增层的参照模板.trellis/spec/ ├── index.md # Spec 总索引项目形态、各目录 Scope、编辑前检查、验证基线 ├── backend/ # Rust/Tauri、SQLite、剪贴板管道、设置、存储、平台行为 │ ├── index.md # 该层适用范围、指导文件清单、Layer Map、默认规则 │ ├── architecture.md │ ├── clipboard-pipeline.md │ ├── commands-and-events.md │ ├── database-and-storage.md │ └── settings-window-platform.md ├── frontend/ # React、Ant Design、UnoCSS、Valtio、命令封装、i18n、UI 质量 │ ├── index.md │ ├── component-guidelines.md │ ├── directory-structure.md │ ├── hook-guidelines.md │ ├── quality-guidelines.md │ ├── state-management.md │ └── type-safety.md └── guides/ # 跨层与代码复用检查清单 ├── index.md ├── code-reuse-thinking-guide.md └── cross-layer-thinking-guide.md从该结构可以推断backend与frontend是按技术栈分层的典型写法对应单仓库布局guides则承载跨层共享的思考清单如果项目采用 monorepo 布局则同一模式可套用到包级路径下例如.trellis/spec/webapp/security/。EcoPaste 的 spec 总索引 还强调了层级归属原则涉及系统剪贴板、持久化、内容检测、OS 集成或已存设置的行为应首先在 Rust 侧设计前端只渲染命令结果——新增 spec 层时应保持这一Rust-first的工程约定。常见需求与改动位置速查表需求改动位置新增 backend/frontend/docs/test spec 层.trellis/spec/layer/或monorepo 时.trellis/spec/package/layer/新增共享思考指南.trellis/spec/guides/调整 monorepo 包映射.trellis/config.yaml中的packages修改默认包.trellis/config.yaml中的default_package控制 spec 扫描范围.trellis/config.yaml中的spec_scope让某个任务读取新 spec任务目录下的implement.jsonl/check.jsonl这张表是本次操作的核心索引spec 内容的增删改集中在.trellis/spec/包映射与范围配置集中在.trellis/config.yaml而任务的上下文引用则在任务 JSONL 中维护。三者职责分明不要混淆。新增一个 Spec 层Add A Spec Layer单仓库布局.trellis/spec/layer/以新增安全约定层为例单仓库布局下应创建如下目录与文件.trellis/spec/security/ ├── index.md └── auth.mdMonorepo 布局.trellis/spec/package/layer/若项目为 monorepo且该约定只约束webapp包则路径前移一层带上包名.trellis/spec/webapp/security/ ├── index.md └── auth.mdindex.md必须包含的四项内容无论单仓库还是 monorepoindex.md都是该层的入口与路由页应包含What code this layer applies to——该层约束哪些代码例如本层适用于所有 Rust 命令封装层代码Pre-Development Checklist——开发前检查清单如 EcoPaste backend 层的index.md就在Guides表中列出何时阅读哪份指导文件并给出模块职责对照表Quality Check——质量检查项EcoPaste 总索引在 Verification Baseline 中给出了前端pnpm lint/pnpm tsc、Rust 侧cargo fmt cargo clippy -- -D warnings cargo test的基线新增层可照此编写自己的检查清单Links to specific guideline files——指向具体指导文件的相对链接EcoPaste 的 backend/index.md 与 frontend/index.md 都以表格形式列出Guide | Scope并链接到各自的具体指导文件是最值得仿效的模板。与仓库现有 spec 层的对比验证EcoPaste 仓库的.trellis/spec/完全印证了上述要求分层backend、frontend、guides三层的index.md均包含 Scope 表格与指向具体指导文件的链接其中 backend/index.md 的Layer Map表将src-tauri/src/commands/、clipboard/、db/、settings/、window/等模块一一对应到其职责这正对应该层适用于哪些代码。适用对象.trellis/spec/的index.md明确了每个目录的 Scope如frontend覆盖 React, Ant Design, UnoCSS, Valtio mirrors, command wrappers, i18n, UI quality新增层时请保持这种目录 职责的清晰边界。更新任务上下文Update Context让任务真正读取新 spec新增 spec并不等于每个任务都会自动读取它。Trellis 的机制是当前任务必须在 JSONL 上下文中显式引用该 spec 路径AI 才会在实施/检查阶段携带该约定。这一步通过.trellis/scripts/task.py的add-context子命令完成python3 ./.trellis/scripts/task.py add-context task implement .trellis/spec/webapp/security/index.md Security conventions python3 ./.trellis/scripts/task.py add-context task check .trellis/spec/webapp/security/index.md Security review rules命令参数拆解参数含义说明task目标任务目录名指向.trellis/tasks/下的任务目录implement/check目标 JSONL 文件分别写入implement.jsonl或check.jsonlspec 路径要注入的上下文文件建议使用仓库根目录起点的相对路径末尾的引号字符串注入理由例如 Security conventions让 AI 理解这段上下文的用途从 task.py 源码 可以确认该子命令的真实行为cmd_add_context为已注册的命令处理器其帮助文本为Add jsonl entry用法为python3 task.py add-context dir file path [reason]脚本自带的示例也印证了标准调用形态python3 task.py add-context dir implement .trellis/spec/cli/backend/auth.md Auth guidelines。JSONL 中每条记录的结构形如{file: path, reason: why}并且只应放入 spec / research 类文件不放入代码路径。仓库任务目录.trellis/tasks/archive/2026-07/07-03-onboarding-admin-launch/implement.jsonl中的示例行也再次强调spec 路径应可通过get_context.py --mode packages列出核对。修改 Monorepo 包映射Change Monorepo Packages编辑.trellis/config.yaml的packages与default_package当项目采用 monorepo 布局时在.trellis/config.yaml中声明包映射与默认包packages: webapp: path: apps/web api: path: apps/api default_package: webapp字段说明packages包名到路径的映射Trellis 在trellis init时通常会自动检测 workspaces见 config.yaml 注释也可手动配置EcoPaste 的config.yaml注释中还提示了更高级用法对于 polyrepo / meta-repo 布局子目录各自含独立.git可在包上标记git: true让运行时按独立仓库处理default_package未显式指定--package时使用的默认包。改动后必须运行验证命令编辑完config.yaml后运行上下文获取脚本确认 AI 能看到正确的包与 spec 层python3 ./.trellis/scripts/get_context.py --mode packages从 task.py 的帮助文本可确认该脚本即用于列出可用 specsRun \python3 .trellis/scripts/get_context.py --mode packages to list available specs。建议将输出与预期映射逐项比对每个声明的包都应出现在结果中且 spec 层路径与.trellis/spec/ 实际目录一致。注意.trellis/config.yaml中packages、default_package、spec_scope等键在当前 EcoPaste 仓库中均为注释状态单仓库布局不需要包级隔离。文章中的 YAML 示例为 monorepo 场景的标准写法开启/声明后即可生效同时config.yaml还包含session_commit_message、max_journal_lines、channel.worker_guard、codex.dispatch_mode等其他项目级配置改动时请避免破坏原有键。附加说明NotesSpecs 是用户项目的工程约定可根据项目需要自由修改但不要将临时任务信息写入 specs——临时信息应放在任务中.trellis/tasks/下的prd.md、implement.jsonl等长期约定不要只写在 agents 或 commands 中应沉淀到 specs否则可能被平台更新或技能覆盖改动 spec 结构后务必检查存量任务 JSONL 是否仍指向已存在的文件——若旧 spec 文件被移动或删除任务上下文中引用的路径会失效导致 AI 无法读取相应约定。可用python3 ./.trellis/scripts/get_context.py --mode packages列出现有可用 specs逐条核对任务引用。与 EcoPaste 的工程约定保持一致spec 层与仓库实际技术栈对应Rust 侧src-tauri/src/、React 侧src/新增层时优先复用 backend、frontend、guides 的既有组织模式保证 AI 上下文注入的一致性与可维护性。赞分享桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载相关推荐Trellis 本地规范结构定制实战从 .trellis/spec 到 config.yaml 的完整指南Trellis 本地规范结构定制实战从 .trellis/spec 到 config.yaml 的完整指南 导读 在 Trellis 驱动的工程流程中 .t桌面应用Trellis 项目本地定制指南从意图识别到修改落地的完整操作手册EcoPaste 仓库 trellis-meta 技能解析Trellis 项目本地定制指南从意图识别到修改落地的完整操作手册EcoPaste 仓库 trellis meta 技能解析 Trellis 通过 tre桌面应用EcoPaste 开发工作流定制 Trellis 三 Agenttrellis-research / trellis-implement / trellis-check的完整实践指南EcoPaste 开发工作流定制 Trellis 三 Agenttrellis research / trellis implement / trellis桌面应用上一篇二维码被刮花就废了我用这款免费工具把损坏二维码修复到可解码下一篇Windows 本地音乐播放器怎么选MusicPlayer2 把歌词、曲库和格式转换一次做齐了创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

用 React 写 CLI 是什么体验?—— Ink 框架深度解析与 TaoToken 配置实战 2026/9/29 6:58:38

用 React 写 CLI 是什么体验?—— Ink 框架深度解析与 TaoToken 配置实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

阅读更多 →
OpenClaw 入门:本地 AI 助手架构、功能与使用场景说明(2026-3月最新版) 2026/9/29 6:58:37

OpenClaw 入门:本地 AI 助手架构、功能与使用场景说明(2026-3月最新版)

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

阅读更多 →
Figma API 密钥获取及 MCP 配置:TaoToken 统一 Key 接入 settings.json 骨架 2026/9/29 6:58:30

Figma API 密钥获取及 MCP 配置:TaoToken 统一 Key 接入 settings.json 骨架

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

阅读更多 →
Gram-Schmidt正交化数值稳定性深度解析:从CGS到MGS与Householder 2026/9/29 6:58:18

Gram-Schmidt正交化数值稳定性深度解析:从CGS到MGS与Householder

写这篇Gram-Schmidt正交化笔记,起因是上周帮一位做点云配准的朋友排查程序异常。他从激光扫描数据里提取了一组近似线性相关的测量向量,想恢复出坐标系的三个标准正交基——这是Gram-Schmidt正交化最典型的应用场景。结果他直接套了网上最常见的经典算法…

阅读更多 →
KubeVela workflow 中的 step-group 步骤:用 subSteps 并行编排子步骤 2026/9/29 6:58:18

KubeVela workflow 中的 step-group 步骤:用 subSteps 并行编排子步骤

云原生DevOps运维微服务 【免费下载链接】kubevela The Modern Application Platform. 项目地址: https://gitcode.com/gh_mirrors/ku/kubevela 点击查看 免费下载 KubeVela 的应用工作流(workflow)支持以 step-group 这一特殊内置步骤&…

阅读更多 →
手搓UDS Bootloader|全网独家复现0x31例程控制、解析Flash分页擦除与0x78长耗时响应、助力ECU固件预擦除、车载OTA升级、产线刷写稳定落地 2026/9/29 6:58:18

手搓UDS Bootloader|全网独家复现0x31例程控制、解析Flash分页擦除与0x78长耗时响应、助力ECU固件预擦除、车载OTA升级、产线刷写稳定落地

目录 一、前言 二、0x31例程控制服务核心体系与原理 2.1 服务核心定位与量产应用场景 2.2 Flash硬件擦除底层核心机制 2.3 协议强制约束与超时规范 2.4 0x31服务子功能与例程规则 三、0x31标准报文与NRC错误码全解析 3.1 完整交互报文格式 3.2 量产高频NRC否定响应码 …

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉