桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载这份技能文档定义了一套「Trellis Spec Bootstrap」工作流让单个具备完整能力的 Agent 在不依赖特定宿主、CLI 或 Agent 品牌的前提下从真实代码库出发创建或刷新.trellis/spec/编码规范。本文结合 EcoPasteTauri v2 React 的跨平台剪贴板管理工具仓库中已经落地的.trellis/spec/目录与相关源码逐条解析该技能的工作流、参考路由、操作规则与完成标准并深入四个 reference 文档说明如何把模板化的规范转化为有源码证据支撑的项目专属规范。技能定位规范要描述这个仓库而不是泛泛的工程SKILL.md 开头的 Frontmatter 明确了这个技能的触发条件description 字段创建或刷新.trellis/spec/规范指南时使用 GitNexus、ABCoder 或源码直接检查来分析代码库时按包/层拆解 spec 编写工作时编写有真实代码库支撑、不含占位符文本的规范文档时。核心思想是一句话Trellis specs are coding guidance for future agents. They should explain how to work in this repository, not how a generic project might be organized.引用自 spec-writing.md。也就是说.trellis/spec/的价值不在于复述通用工程实践而在于把当前仓库的边界、模式、反模式和验证方式固化下来让未来的 Agent 直接复用。在 EcoPaste 仓库中这一理念已经落地为可观察的结果.trellis/spec/下按backend/、frontend/、guides/三个目录组织其 总索引 明确写道这些 spec capture how EcoPaste is built today并约定当与AGENTS.md重叠时AGENTS.md是项目级权威spec 文件提供源码级的补充细节。核心工作流单 Agent 全程闭环的五步法SKILL.md 将整个流程定义为单 Agent 拥有完整闭环分析仓库 → 划定 spec 边界 → 编写文档 → 验证结果。具体步骤如下确认 Trellis 已初始化并检查当前.trellis/spec/目录树用最好的可用工具分析仓库架构GitNexus、ABCoder、语言工具链、直接阅读源码只有当分解确实反映真实代码结构时才按包和层拆解 spec 工作用项目中的具体模式、文件路径、示例和反模式填充或重塑 spec 文件验证最终 spec 内部一致且不含模板占位符。这套流程的独特之处在于第 3 步——它明确反对为分解而分解。spec-task-planning.md 对此给出了更具体的判断标准spec 工作单元应围绕真实的所有权边界创建——某个包有自己的约定时为一个包建单元同一包内 frontend/backend/CLI/worker/shared-library 规则不同时按层拆分当某个模式横跨多个包且不归任何单一层所有时创建一条跨层指南。Avoid artificial decomposition. A small library usually needs one focused spec pass, not several tasks.避免人为分解小型库通常一次聚焦的 spec pass 就够不需要拆成多个任务。参考路由表按需求快速定位参考文档SKILL.md 内置了一张需要什么 → 读哪份文档的路由表是使用该技能时最常用的导航工具NeedRead仓库架构分析references/repository-analysis.mdSpec 工作分解与任务规划references/spec-task-planning.md编写高信号 Trellis spec 文件references/spec-writing.mdGitNexus 和 ABCoder MCP 配置references/mcp-setup.md注意这张路由表引用的是技能包内部的相对路径在实际使用 Trellis 时这些文档位于技能的references/子目录下配合仓库根目录下的.trellis/树使用。EcoPaste 的.trellis/spec/内部也采用了同样的索引 路由组织方式例如 backend/index.md 中就有什么时候该读哪份指南的表格Architecture / Commands and Events / Clipboard Pipeline / Database and Storage / Settings, Windowing, and Platform与 SKILL.md 的路由表结构一一对应。操作规则六条必须遵守的约束SKILL.md 定义了六条 Operating Rules它们是整个 bootstrap 过程的纪律底线把模板当起点而非契约。当仓库结构需要时可以删除、重命名、拆分或新增 spec 文件。这与按真实代码结构分解的原则一脉相承——模板只是草稿代码才是最终裁决者。优先写有源码支撑的规则而不是泛泛建议。每条重要建议都应指向一个真实文件或重复出现的本地模式。这正是 spec-writing.md 中 Write From Evidence 的要求。默认单 Agent 执行。可选辅助 Agent 只是实现细节不是必需项也不应成为用户可见的依赖。不写平台特定指令除非目标项目本身已经标准化在该平台上。不在.trellis/spec/中留下占位符文本、空标题或照搬的样板内容。最后一条规则直接引出了完成标准里的验证动作。完成标准什么样的 spec 才算合格SKILL.md 的 Done Criteria 给出了可验证的收尾清单.trellis/spec/描述的是当前存在的项目而不是目标状态每个相关包或层都有带真实示例的实用编码指导不适用的模板章节已被删除index.md与最终的 spec 文件集合保持一致任何必要的安装或分析前提都记录在相关 spec 或任务笔记中。EcoPaste 的 spec 树正好可以作为这些标准的对照样本.trellis/spec/的 总索引、backend/index.md、frontend/index.md、guides/index.md 四份索引均列出了各自目录下的实际指南文件而每个目录下的.md文件与索引一一对应没有悬空的模板文件。结合 EcoPaste 实测参考文档的落地拆解四个 reference 文档是 SKILL.md 的操作细节下面结合 EcoPaste 仓库逐一展开。repository-analysis.md先读代码再定 spec 结构这份文档的核心方法论是Do not start from generic spec templates and fill blanks. Start from the code, then let the spec structure follow.不要从通用模板出发填空从代码出发让 spec 结构跟随代码。它给出的分析顺序是阅读现有.trellis/spec/树标注哪些文件是模板、哪些已过时、哪些已项目化检查包清单、构建脚本、workspace 配置和顶层文档识别包与运行时层用 GitNexus 分析执行流、模块簇、依赖枢纽和影响敏感区域用 ABCoder 或语言原生工具获取精确签名、类型、类边界和实现示例在把任何发现写成 spec 规则之前直接阅读有代表性的源码和测试文件。它还定义了一张要捕获什么的清单覆盖六个方面包边界每个包拥有什么、哪些导入跨越边界、运行时层CLI/backend/frontend/worker/shared-library/test-only/tooling、核心抽象哪些类型、服务、store、命令、路由或适配器定义了系统形态、数据流用户输入从哪里进入、如何校验、状态在哪里持久化、错误处理失败如何表示、记录、暴露和测试、配置默认值、环境配置、生成文件、模板在哪里、测试哪些测试风格是可信任的新工作示例。对照 EcoPaste这正是 .trellis/spec/index.md 中 Project Shape 一节的来源。索引将 EcoPaste 描述为 a Tauri v2 desktop app for macOS and Windows产品行为 Rust-first剪贴板读写、数据库、设置持久化、窗口定位、快捷键、托盘、自启动、备份、存储都在src-tauri/src/React 应用src/负责渲染 UI、镜像设置、处理常规交互通过类型化命令包装器调用 Rust。而 backend/index.md 的 Layer Map 表格则完整回答了包边界问题src-tauri/src/commands/拥有 Tauri 命令边界校验输入、读 State、调用下层、丰富响应模型src-tauri/src/clipboard/拥有 OS 剪贴板读写、内容摄取、来源应用检测、资源存储与回环抑制src-tauri/src/db/拥有 sqlx 仓库、SQLite 模型、迁移、FTS、测试数据库辅助依此类推。spec-task-planning.md任务形状与可选辅助 Agent这份文档主张默认单 Agent 执行并给出三种分解单元单包、单层同一包内不同层的规则、跨层指南。当需要创建 Trellis 任务时它提供了一个精简 PRD 模板包含 Goal / Scope / Architecture Context / Files To Create Or Update / Rules / Acceptance Criteria 六个小节。其中 Rules 一节再次强调适应真实代码库、使用带文件路径的真实源码示例、删除不适用的模板章节、除非任务明确要求否则不修改产品源码。可选辅助 Agent 的使用原则是必须职责清晰只读研究任务可以检查范围内任何需要的源码写任务应拥有互不重叠的 spec 目录验证任务负责检查占位符清理、损坏链接和一致性。EcoPaste 的.trellis/结构印证了这套任务体系.trellis/tasks/archive/下按日期归档了 bootstrap-guidelines、auto-updater、onboarding、README-docs 等任务目录每个目录含prd.md、task.json、implement.jsonl、check.jsonl等文件.trellis/agents/下有implement.md和check.md.trellis/根下有config.yaml和workflow.md构成完整的 Trellis 运行时。spec-writing.md高信号 spec 的写法这份文档回答怎么写的问题要点包括从证据出发Write From Evidence每条重要规则必须有四类证据之一——展示首选模式的源文件、展示预期行为的测试文件、定义约定的项目文档、跨多个文件重复出现的模式。示例应短小精悍优先链接文件路径并点名符号或行为。文件结构index.md始终作为 spec 目录的导航文件开发者在不同场景会独立查找的主题就拆分会重复同样规则的专题就合并删除不适用的模板文件为模板遗漏的重要本地模式新增文件。内容标准一个好的 spec 小节应包含——规则何时适用、要遵循的本地模式、证明该模式的源文件或测试文件、常见错误或反模式、可靠且具体的验证命令。应避免占位符散文、泛泛的框架建议、只在一个 Agent 宿主上有效的工具指令、过长代码块、基于单次偶然实现细节的规则。收尾检查执行grep -R To be filled\|TODO: fill\|placeholder .trellis/spec检查占位符残留并复查链接、索引文件确认没有 spec 仍在描述模板而非本仓库。EcoPaste 的 spec 文件完美体现了这些标准。以 backend/clipboard-pipeline.md 和 backend/commands-and-events.md 为例它们讨论的是src-tauri/src/clipboard/与src-tauri/src/commands/下的真实模块frontend/state-management.md 将src/stores/settings.ts定义为 settings mirror、src/stores/clipboardView.ts定义为 UI 状态镜像并明确不要把数据库状态复制到前端。这些规则背后都有确凿的源码证据比如 frontend/index.md 的 Primary References 列表直接给出了src/App.tsx、src/hooks/useAppTheme.ts、src/commands/index.ts、src/pages/Clipboard/components/List.tsx、src/pages/Preference/config/preferenceSchema.ts、src/components/ClipboardGroupIcon/index.tsx等文件后者专门用于用户提供的 SVG 清理是从源码中提炼出的真实模式。mcp-setup.mdGitNexus 与 ABCoder 的接入与验证GitNexus 和 ABCoder 是推荐但不强制的工具选项通过宿主提供的任何 MCP 机制接入。关键命令行操作如下GitNexus 安装与索引在仓库根目录运行# 构建代码知识图谱 npx gitnexus analyze # 检查索引状态 npx gitnexus status # 代码变更后重新索引 npx gitnexus analyze索引写入.gitnexus/目录只有项目已经在用 embeddings 时才保留它们常规索引对 spec bootstrap 已经足够。MCP 服务器命令为npx -y gitnexus mcpGitNexus 的六个核心工具及用途gitnexus_query按概念查找执行流和功能区域、gitnexus_context检查某符号的调用者、被调者、引用与流程参与、gitnexus_impact修改符号前理解爆炸半径、gitnexus_detect_changes收尾前检查变更符号与受影响流程、gitnexus_cypher直接跑图查询、gitnexus_list_repos列出已索引仓库。文档强调用 GitNexus 结果定位重要文件和流程但在核对相关源文件之前不要把图谱输出当作最终权威。ABCoder 安装go install github.com/cloudwego/abcoderlatest abcoder --help解析仓库monorepo 下每个包用稳定的--name解析以便任务笔记引用同名仓库abcoder parse /absolute/path/to/package \ --lang typescript \ --name package-name \ --output ~/abcoder-astsMCP 服务器命令abcoder mcp ~/abcoder-asts。ABCoder 的五个分层工具list_repos列出已解析仓库、get_repo_structure查看包与文件、get_package_structure查看包内节点、get_file_structure查看文件内函数/类/类型/签名、get_ast_node检索代码、依赖、引用与实现。它对记录构造器模式、函数签名、类型契约和引用链最有价值。配置完成后需要验证两个 MCP 服务器在宿主中可见并对每台服务器各跑一次简单查询再开始写作ls .gitnexus/meta.json ls ~/abcoder-asts/*.json在 EcoPaste 中的落地形态spec 树与验证基线把 SKILL.md 的方法论映射到 EcoPaste可以看到完整的落地产物.trellis/spec/backend/architecture.md、clipboard-pipeline.md、commands-and-events.md、database-and-storage.md、settings-window-platform.md覆盖 Rust/Tauri 模块、SQLite、剪贴板管线、设置、存储与平台行为.trellis/spec/frontend/directory-structure.md、component-guidelines.md、hook-guidelines.md、state-management.md、quality-guidelines.md、type-safety.md覆盖 React/Ant Design/UnoCSS/Valtio 镜像/命令包装器/i18n/UI 质量.trellis/spec/guides/code-reuse-thinking-guide.md添加常量、包装器、helper、设置、命令、action 或重复 UI 时读与cross-layer-thinking-guide.md数据在 Rust、SQLite、Tauri events、TypeScript、UI 之间移动时读。其中 guides/index.md 还给出了一条高频路由Fast Routing和一条实用习惯Usergbefore adding a new contract or value. Most cross-layer bugs here come from updating one mirror and missing another.——先用rg搜索再新增契约或值因为这类仓库里大多数跨层 bug 来自更新了一个镜像却漏了另一个。这条习惯恰好呼应了 .trellis/spec/index.md 中的约定命令名由src-tauri/src/lib.rs与src/constants/commands.ts镜像事件名由 Rust 常量与src/constants/events.ts镜像。最后spec 索引还固化了验证基线Verification Baseline这正是 SKILL.md 完成标准中可验证的具体化前端pnpm lint与pnpm tscTypeScript 与 Biome 检查Rustcd src-tauri cargo fmt cargo clippy -- -D warnings cargo testUI 变更仍需在受影响窗口手动跑一遍——该项目目前未配置前端测试运行器。这套索引 分层指南 源码证据 验证命令的组合正是 Trellis Spec Bootstrap 技能期望产出的最终形态规范不再是给未来 Agent 的抽象建议而是当前代码库的可导航、可验证、可执行的地图。当你在任何 Tauri React 项目中需要让 Agent 快速对齐代码边界与协作约定时都可以用同样的五步流程从 SKILL.md 出发走完分析、分解、写作与验证的完整闭环。赞分享桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载相关推荐EcoPaste 仓库的 Trellis Spec Bootstrap 实践以单 Agent 工作流从真实代码库构建编码规范EcoPaste 仓库的 Trellis Spec Bootstrap 实践以单 Agent 工作流从真实代码库构建编码规范 导读 本文围绕 EcoPaste桌面应用EcoPaste 的 Trellis Spec Bootstrap从真实代码库引导项目级编码规范EcoPaste 的 Trellis Spec Bootstrap从真实代码库引导项目级编码规范 本文讲解 EcoPaste 仓库中 .claude/skil桌面应用为 AI 编码 Agent 编写有据可依的仓库规范Trellis Spec Writing 方法论与 EcoPaste 实践解析为 AI 编码 Agent 编写有据可依的仓库规范Trellis Spec Writing 方法论与 EcoPaste 实践解析 导读 Trellis Spe桌面应用上一篇InvenTree 开源库存管理指南零件、BOM 与库存流转免费搞定下一篇Fleet 如何帮助联邦机构满足 CISA BOD 23-01 漏洞枚举合规要求创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考