桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载本文围绕 EcoPaste 仓库内.agents/skills/trellis-spec-bootstrap/references/spec-task-planning.md的核心内容展开讲解在基于 Trellis 的 AI 编码工作流中如何为.trellis/spec/规范文档创建工作单元spec work units、如何编写可验收的 Trellis 任务 PRD以及如何在不依赖特定平台与 CLI 的前提下组织可选辅助 Agent。读完本文你将掌握一套平台无关platform-neutral的规范引导spec bootstrap任务规划方法并能够直接在类似 EcoPaste 这样Rust-First 前端展示的 Tauri 仓库中落地执行。一、定位这份文档在 Trellis 工作流中的角色EcoPaste 仓库使用 Trellis 管理 AI 编码工作流。根据 AGENTS.md 中维护的 Trellis 指令块项目的工作知识按以下目录组织.trellis/workflow.md—— 开发阶段划分、何时创建任务、技能路由.trellis/spec/—— 按包package和层layer划分的编码规范写代码前先读对应层规范.trellis/workspace/—— 开发者日志与会话痕迹.trellis/tasks/—— 进行中与已归档的任务PRD、研究资料、jsonl 上下文。而.agents/skills/目录下存放了一组可复用的 Trellis 技能其中trellis-spec-bootstrap专门负责从真实代码库创建或刷新.trellis/spec/规范。本次作为主体的 spec-task-planning.md 正是该技能工作流中关于规范工作分解与任务规划的参考文档与同级参考文档 repository-analysis.md仓库架构分析和 spec-writing.md规范写作共同构成完整的引导闭环。在 EcoPaste 仓库的实际环境中这类规划直接服务于为src-tauri/Rust 后端与src/React 前端编写项目专属的编码规范——即把 AGENTS.md 中已经沉淀的架构边界如剪贴板监听、数据库读写、窗口定位必须在 Rust 实现进一步拆解为可被未来 Agent 直接执行的.trellis/spec/layer/topic.md文档。二、默认执行模型单 Agent 全流程所有权文档开头即给出一个关键设计决策默认使用单个 Agent 作为执行模型。该 Agent 可以为了可追溯性traceability创建 Trellis 任务但技能本身不应要求特定平台、特定 CLI 或并行 worker 模型。这一原则在 SKILL.md 中有更完整的展开一个有能力capable的 Agent 拥有整个闭环——分析仓库、选择规范边界、撰写文档、验证结果并且工作流不依赖特定宿主、CLI 或 Agent 品牌。对应的五步工作流为确认 Trellis 已初始化并检查当前.trellis/spec/树用可得的最好工具GitNexus、ABCoder、语言工具链、直接源码阅读分析仓库架构仅在符合真实代码库形态时按包与层分解规范工作用项目中的真实模式、文件路径、示例与反例填充或重塑规范文件验证最终规范内部一致、无模板占位符。值得注意的约束是EcoPaste 仓库的 biome.json 已将.trellis/.runtime列入 lint/format 排除范围说明.trellis/目录被当作仓库正式管理的工作区资产其内容包括任务规划产生的 spec 文件不应被代码格式化工具意外改动——这也印证了单 Agent 执行时需要尊重仓库既有的目录约定。实践要点作为执行 Agent你应该默认承担从分析到验证的全部工作平台是否提供/trellis:*命令、是否存在辅助 Agent都不应成为技能能否运行的前提。三、工作单元分解Decomposition围绕真实所有权边界文档明确反对为了拆分而拆分。规范工作单元应围绕真实的所有权边界real ownership boundaries创建具体规则如下一个包对应一个工作单元当一个包有自己的约定conventions时以包为单位同一包内按层拆分当同一个包内部存在不同的前端、后端、CLI、worker 或共享库规则时按层layer拆分跨层模式单独成文当一个模式跨越多个包且不归属于某一层时创建一个跨切面cross-cutting指南避免人为拆分一个小型库通常只需要一次聚焦的规范引导spec pass而不是多个任务。把这一原则映射到 EcoPaste 的真实代码结构上可以给出清晰的拆分示范。从仓库目录结构看项目明显分为两大层层目录典型所有权内容Rust 后端src-tauri/src/commands/tauri command 入口只做校验与转发、db/sqlx 仓储、clipboard/剪贴板读写与监听、window/窗口管理、keystroke/、keyboard/、tray/、menu/等React 前端src/components/、pages/、stores/、hooks/、locales/、utils/跨层契约两端共享命令名、事件名、channel/storage key 等字面量的集中维护Rust 模块常量 src/constants/ 同步更新结合 AGENTS.md 的架构边界约定可以推断在 EcoPaste 上做规范引导时合理的分解方案是后端一层 前端一层 一个跨端契约指南而不是为每个 Rust 子模块clipboard/、window/、db/等各建一个任务——因为它们共享同一套 Rust 约定async 命令、ResultT, AppError、thiserror/anyhow错误处理等可以合并为一次聚焦的后端规范引导。四、任务形态Task Shape可直接复用的 PRD 模板当 Trellis 任务确实有用时文档要求编写一份简洁的 PRDProduct Requirements Document并给出了完整的七段式模板。该模板是本篇的核心可复用资产完整继承如下# Fill package-or-layer Trellis Specs ## Goal Write project-specific .trellis/spec/ guidance for scope. ## Scope - Spec directory: - Source directories to inspect: - Tests to inspect: - Out of scope: ## Architecture Context Summarize the concrete findings from repository analysis. ## Files To Create Or Update - .trellis/spec/.../index.md - .trellis/spec/.../topic.md ## Rules - Adapt the spec file set to the real codebase. - Use real source examples with file paths. - Remove template-only sections that do not apply. - Do not modify product source code unless the task explicitly asks for it. ## Acceptance Criteria - [ ] Specs contain concrete examples and anti-patterns from the repository. - [ ] No placeholder text remains. - [ ] Index files match the final spec files. - [ ] Claims are backed by source files, tests, or project docs.各段落的填写要点Goal目标一句话说明要为哪个范围编写项目专属的.trellis/spec/指南。例如在 EcoPaste 中可以是为src-tauri/Rust 后端层编写项目专属规范。Scope范围明确四个维度——目标规范目录、需要检查的源码目录、需要检查的测试、明确排除的内容。排除项的写法尤其重要它能防止 Agent 越界修改产品代码或无关模块。Architecture Context架构上下文先做仓库分析再写任务而非从模板出发填空。这与 repository-analysis.md 的核心指令一致不要从通用 spec 模板开始填空要从代码出发再让规范结构跟随代码。分析阶段需要捕获的信息包括包边界每个包拥有什么、哪些导入跨越边界、运行时层CLI/后端/前端/worker/共享库/测试工具、核心抽象类型、服务、存储、命令、路由、数据流用户输入从哪进入、如何校验、状态持久化在哪、错误处理失败如何表示、记录、展示、测试、配置默认值、环境配置、生成文件、模板在哪、测试哪些测试风格是可信范例。Files To Create Or Update待创建或更新的文件明确列出index.md与主题文档。根据 spec-writing.md 的结构原则index.md保持为规范目录的导航文件主题在开发者会独立查找时拆分、在重复时会合并、不适用的模板文件删除、模板遗漏的重要本地模式则新增文件。Rules规则四条硬性规则——规范文件集必须适配真实代码库必须使用带文件路径的真实源码示例删除不适用的模板段落除非任务明确要求不得修改产品源码。Acceptance Criteria验收标准四条可勾选的标准构成完成定义的底线——规范包含来自仓库的具体示例与反例、无占位符残留、index 文件与最终规范文件集一致、所有论断都有源码/测试/项目文档支撑。与仓库既有质量标准的衔接PRD 模板中的Claims are backed by source files, tests, or project docs与 spec-writing.md 的证据驱动写作一脉相承每条重要规则都应由以下之一背书——展示偏好的模式的源文件、展示预期行为的测试文件、定义约定的项目文档、或多个文件中的重复模式。而 EcoPaste 仓库恰好提供了大量可作证据的实体例如 AGENTS.md 中的 Rust 约定命令与仓储函数使用async并返回ResultT, AppError、SQL 用sqlx::query/query_as而非query!宏、已发布 migration 不回改等都是可直接写入 spec 并以src-tauri/src/下真实文件为引用的素材。五、可选辅助 AgentOptional Helper Agents有清晰所有权的分工文档将辅助 Agent 明确定位为可选项如果宿主支持子代理subagents辅助 Agent 可以检查独立包或运行验证但主 Agent 仍然拥有集成与最终质量的所有权。技能内部不应编码辅助 Agent 的名称、厂商特定命令或平台特定路由——任务里只放必要的工作与验收标准。辅助任务的职责边界按类型划分只读研究任务Read-only research tasks可以检查分配范围内任何需要的源码写入任务Write tasks应拥有不相交的规范目录disjoint spec directories避免并发写入冲突验证任务Verification tasks检查占位符是否清除、链接是否断裂、整体一致性。结合 SKILL.md 的运行规则可以确认默认单所有权执行可选辅助 Agent 是实现细节不是要求或用户可见依赖且除非目标项目已经标准化于某平台否则不要写平台特定指令。因此在 EcoPaste 这样的仓库中合理的辅助 Agent 用法是让一个只读 Agent 独立核查src-tauri/src/db/例如确认query_as字段与测试结构体字面量的一致性同时让主 Agent 处理前端规范两端规范目录互不重叠最后由主 Agent 统一验收。六、规划产出的质量闭环验证与一致性任务规划不只是写出 PRD还隐含了最终的质量闭环。结合本技能体系规划阶段的验收标准应与执行阶段的终检衔接占位符清理最终.trellis/spec/不得残留占位符文本。trellis-spec-bootstrap体系的 spec-writing.md 提供了可执行的终检命令grep -R To be filled\|TODO: fill\|placeholder .trellis/spec链接与索引一致性检查链接、index 文件以及是否有任何 spec 仍在描述模板而非当前仓库。与既有技能衔接本技能的引导职责与trellis-update-spec技能的持续更新职责见 trellis-update-spec/SKILL.md形成前后端闭环——引导阶段建立可执行的契约文档后续每次调试、修复、实现产生的可执行契约再回流更新对应 spec 文件这正是 EcoPaste 中 Trellis 体系把一次会话学到的知识沉淀为跨会话的机构记忆的实现方式。七、在 EcoPaste 上的落地示例将本文所述方法应用到 EcoPaste一次典型的 Trellis 规范引导任务规划可以这样填充# Fill src-tauriRust 后端层Trellis Specs ## Goal 为 Rust 后端层编写项目专属 .trellis/spec/ 指南覆盖命令层、DB 层与剪贴板模块的编码契约。 ## Scope - Spec directory: .trellis/spec/backend/ - Source directories to inspect: src-tauri/src/commands/、src-tauri/src/db/、src-tauri/src/clipboard/、src-tauri/src/core/ - Tests to inspect: src-tauri/src/db/ 下的仓储测试、cargo test 覆盖的模块测试 - Out of scope: src/前端规范单独规划、src-tauri/migrations/ 既有 SQL 内容只读参照 ## Architecture Context 仓库采用 Rust-First 的 Tauri 架构commands/ 是薄层参数校验 转发db/ 是 sqlx 仓储与连接池clipboard/ 承担监听与读写命令与仓储均为 async 并返回 ResultT, AppError。 ## Files To Create Or Update - .trellis/spec/backend/index.md - .trellis/spec/backend/commands.md - .trellis/spec/backend/db.md ## Rules - 规范文件集适配真实代码库参考 AGENTS.md 的 Rust 约定章节。 - 使用真实源码示例并标注文件路径。 - 删除不适用的模板段落如无 CLI 层则不写 CLI 相关段落。 - 除任务明确要求外不修改产品源码。 ## Acceptance Criteria - [ ] 规范包含来自仓库的具体示例与反例如 query_as 字段不匹配导致 UI 空结果的反例。 - [ ] 无占位符文本残留。 - [ ] index 文件与最终规范文件集一致。 - [ ] 每条论断都有源码、测试或项目文档支撑。这个示例中的反例素材query_as字段不匹配可能表现为 UI 空结果、平台代码用#[cfg(target_os ...)]隔离、已发布 migration 不回改等全部出自 AGENTS.md是规划任务时可以直接引用的仓库证据。结语spec-task-planning.md提供了一套精简但完备的 Trellis 规范任务规划方法论单 Agent 默认执行、按真实所有权边界分解、用七段式 PRD 模板承载任务、让辅助 Agent 承担有清晰所有权的分工。在 EcoPaste 这类同时拥有 Rust 后端与 React 前端的仓库中这套方法帮助你在不引入额外平台依赖的前提下把 AGENTS.md 沉淀的架构约定逐步转化为.trellis/spec/中可执行、可验收、可被未来 Agent 直接引用的编码规范。赞分享桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载相关推荐Easydict 仓库 Agent 文档治理计划/执行双模式与单一职责规则的精简实践Easydict 仓库 Agent 文档治理计划/执行双模式与单一职责规则的精简实践 本文围绕 Easydict 仓库一次真实的 Agent 文档治理任务2桌面应用AI 应用Easydict 仓库 AGENTS.md 任务模式拆分实践从单一入口到「计划 / 执行 / 通用规则」三层治理Easydict 仓库 AGENTS.md 任务模式拆分实践从单一入口到「计划 / 执行 / 通用规则」三层治理 本文基于 Easydict 仓库中的变更历史桌面应用AI 应用Reflex 仓库 Coding Agent 指南全解析从任务规划到提交的工程化规范Reflex 仓库 Coding Agent 指南全解析从任务规划到提交的工程化规范 导读 AGENTS.md https://link.gitcode.co后端前端Web框架上一篇告别语言障碍Jan多语言界面配置全攻略下一篇微积分学习资源怎么选awesome-math 免费精选 7 套从零基础走到多元微积分创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考