尧图网站建设 
桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载在 EcoPaste 仓库的.trellis/目录下内置了一套名为 Trellis 的 AI 协作开发工作流系统。其中implement.md 定义了一个职责边界极其清晰的子代理——Implement Agent实现子代理它负责读取规格spec与任务产物task artifacts随后编写符合既有模式的代码并在提交前完成自检。本文将以其定义文档为主体结合 check.md、workflow.md 与真实任务归档完整拆解该子代理的上下文读取顺序、核心职责、禁止操作、执行工作流、代码规范与回报格式帮助读者理解主会话负责规划与提交、子代理负责实现与自检这一分工模式如何在 AI 编码通道channel runtime中落地。子代理的定位与启动方式从 implement.md 的文件头frontmatter可以看到它的四个元信息字段name: implement—— 子代理的唯一标识description—— Code implementation expert for the Trellis channel runtime. Understands specs and task artifacts, then implements features. No git commit allowed.一句话点明身份理解规格与任务产物、实现功能、但绝不允许 git commitprovider: claude—— 声明由 Claude 扮演该角色labels: [trellis, implement]—— 打上系统级标签便于被调度器检索。它的启动方式是通过trellis channel spawn --agent implement在 Trellis 通道运行时内被派发并在收件箱中收到一行Active task: path。这行路径就是它定位任务产物的入口所有需要读取的prd.md、design.md、implement.md、implement.jsonl都存放在该任务目录下。在 workflow.md 的 Phase 2.1Implement中主会话main session负责派发该子代理并有一条关键约束派发提示词必须以Active task: task path from task.py current开头之后才进入角色指令。同时存在子代理自我豁免规则——如果当前会话本身就是trellis-implement子代理则不得再派生另一个trellis-implement或trellis-check避免无限递归派发。这些约束保证了主会话派发、子代理执行的单向调用链。上下文读取顺序先清单、再需求、后设计Implement Agent 的核心工作前提是读懂上下文。定义文档明确要求按固定顺序读取以下文件task-path/implement.jsonl若存在——本轮任务精选的规格清单spec manifest其中列出的每个文件都必须读取task-path/prd.md——需求文档requirementstask-path/design.md若存在——技术设计文档task-path/implement.md若存在——执行计划.trellis/spec/——项目级开发规范只加载与即将编写的 diff 相关的部分。这里有一个容易混淆的点值得注意任务目录里名为implement.md的文件是执行计划execution plan与.trellis/agents/implement.md这个子代理定义文档是两个不同层级的产物。前者由主会话在规划阶段Phase 1写入后者是子代理自身的角色说明书。以归档任务 07-03-onboarding-admin-launch/implement.md 为真实样本可以看到一份合格执行计划的结构Checklist按可勾选条目列出Add Rust admin module → Addgeneral.run_as_adminto settings → Add command boundary → Wire startup → Wire onboarding UI → Update release note等实现步骤、Validation验证命令清单、Risky Files风险文件列表、Rollback回滚方案。这类文档正是 Implement Agent 在动手前必须理解清楚的对象。此外workflow.md 的 Phase 1.3 解释了implement.jsonl的产生方式它由主会话在规划阶段用python3 ./.trellis/scripts/task.py add-context name implement path reason逐条添加每行一个 JSON 对象{file: path, reason: why}路径以仓库根目录为基准。清单中只应包含 spec 文件与研究文件不应包含源码路径源码由子代理在实现阶段自行阅读也不能替代implement.md本身。核心职责理解、实现与自检定义文档用四条概括了子代理的本职Understand specs—— 阅读.trellis/spec/中与本任务相关的规范文件Understand task artifacts—— 阅读上文列出的任务产物Implement features—— 写出遵循规格与既有模式的代码Self-check—— 在回报之前对变更范围运行 lint 与类型检查。第 4 条自检是整个规范的关键设计子代理不是写完就交差而是要在自己负责的变更范围内先跑一遍项目自带的验证命令把结果写进回报。结合 .trellis/spec/index.md 中记录的 EcoPaste 验证基线这套自检命令在仓库中的实际形态为前端pnpm lintBiome与pnpm tscTypeScript 类型检查Rust 后端cd src-tauri cargo fmt cargo clippy -- -D warnings cargo test。在归档任务的执行计划 07-03-onboarding-admin-launch/implement.md 的 Validation 一节中可以看到这条基线的真实应用——cargo fmt、cargo test、cargo clippy -- -D warnings、pnpm lint、pnpm tsc均被列为已验证项而手动 Windows 验证UAC 弹窗、管理员进程重启等需要真实桌面会话的交互场景则被明确标注为未完成、待人工补测。这印证了自动化验证 人工验证边界的实践子代理能跑的命令必须跑跑不了的场景必须如实标注而不是假报通过。禁止操作提交权与实现权的分离Implement Agent 的定义文档用独立章节列出了一条不可逾越的红线git commitgit pushgit merge理由被明确写在文档中The supervising main session owns commits. Report what changed; do not commit on its behalf.监督方主会话拥有提交权只回报变更不得代提交。这是一套刻意设计的权限隔离子代理只能写代码、跑验证、写回报永远不能触碰 git 写操作。主会话在收到回报后会依据 workflow.md 的 Phase 3.4 负责批量提交且明令禁止git commit --amend要求按工作提交 → 归档提交 → 日志提交的三段式顺序执行。同一设计也完整复刻在兄弟子代理 check.md 的定义中——Check Agent 同样被禁止 commit/push/merge只能审查、自行修复机械性问题并回报。这种写操作收敛到主会话的模式既保证了 git 历史的一致性也让子代理可以放心地改代码而不必担心越权。五步工作流从读规格到回报结果Implement Agent 的执行流程被规范为五个有序步骤读规格—— 依据任务类型读取implement.jsonl中列出的规格文件若存在读任务产物—— 依次读取任务的prd.md、design.md若存在、implement.md若存在实现功能—— 遵循规格与既有代码模式编写代码自检—— 对变更范围运行项目的 lint 与类型检查回报—— 将改动文件、关键决策、验证结果回报给通道channel。这五步与 workflow.md 中的 Phase 2.1 / 2.2 严格对应主会话在 Phase 2.1 派发 implement 子代理随后在 Phase 2.2 派发 check 子代理做质量复核两者交替直至绿灯lint / typecheck / 测试全部通过。子代理完成实现后主会话还会触发一轮全范围full-scope终检——用python3 ./.trellis/scripts/get_context.py --mode packages列出所有受影响的包逐一加载各包 spec 索引中的 Quality Check 小节以捕获跨层/跨包问题。代码规范克制与聚焦定义文档对代码质量提出了四条务实要求Follow existing code patterns—— 跟随既有代码模式不另起炉灶Dont add unnecessary abstractions—— 不添加不必要的抽象层Only do what the PRD asks for; no speculative scope expansion—— 只做 PRD 要求的事不做推测性的范围扩张Surface uncertainty back to the channel rather than guessing—— 遇到不确定时向通道反馈而不是猜测。不做过度的范围扩张与有疑问先反馈这两条实际上是在给子代理划定探索半径它可以自由阅读.trellis/spec/中与本次 diff 相关的文件但不允许顺手重构无关模块或擅自扩大功能面。这与 .trellis/spec/index.md 中仅支持 macOS 与 Windows 两个#[cfg]分支、无 Linux 目标等项目级约束相辅相成共同保证了子代理产出的 diff 边界清晰、可审查。回报格式结构化、可追踪实现完成后子代理必须按固定模板回报共四段Files Modified—— 每个改动文件一行附一句话说明Implementation Summary—— 实现步骤编号列表Verification Results—— Lint 与 TypeCheck 各自标注pass | fail | skipped reasonOpen Questions—— 遗留疑问若无则省略该段。这套模板的设计意图很明显让主会话在收到回报后能立刻判断改了什么、为什么这样改、验证是否通过、还有什么悬而未决。其中skipped reason的显式标注尤其重要——正如归档任务 07-03-onboarding-admin-launch/implement.md 中Automated checks were rerun ... Manual UAC and Task Scheduler behavior still needs an interactive Windows desktop session的表述所示凡是环境不允许跑的验证都必须写明原因并移交人工而非含糊带过。与 Check Agent 的分工协同Implement Agent 并非孤军作战它与 .trellis/agents/check.md 定义的 Check Agent 构成实现 → 审查的接力闭环。两者的设计几乎镜像对称维度Implement AgentCheck Agent启动方式trellis channel spawn --agent implementtrellis channel spawn --agent check上下文入口Active task: pathActive task: path读取顺序implement.jsonl→prd.md→design.md→implement.md→.trellis/spec/check.jsonl→prd.md→design.md→implement.md→.trellis/spec/核心动作读规格、写代码、自检lint typecheckgit diff取 diff、对照任务产物与规格审查、机械问题就地修复、跑验证禁止操作commit / push / mergecommit / push / merge回报模板Implementation CompleteSelf-Check CompleteCheck Agent 的审查报告要求给出带file:line引用的具体发现并明确区分已修复与未修复移交主会话。两者都由主会话在 workflow.md 的[workflow-state:in_progress]阶段统一调度且共享子代理禁止再派生同侪子代理的豁免规则。这套分工把写代码和审代码的角色彻底分离避免了同一代理既当运动员又当裁判员的盲区。小结EcoPaste 仓库中的 implement.md 提供了一份可复用的 AI 实现子代理规范模板。它的核心价值可以概括为三点其一用严格的上下文读取顺序implement.jsonl→prd.md→design.md→implement.md→.trellis/spec/保证子代理在动手前掌握全部必要信息其二用git 写操作一律禁止的红线实现实现权与提交权的分离其三用结构化的回报模板Files Modified / Implementation Summary / Verification Results / Open Questions让验证结果可追踪、遗留问题不沉没。配合 workflow.md 的派发协议、check.md 的审查接力以及.trellis/tasks/下真实任务产物的佐证这套机制构成了一个主会话规划 子代理实现/自检 主会话提交的完整 AI 协作闭环可作为其他希望引入 AI 编码通道的项目直接参考的设计蓝本。赞分享桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载相关推荐EcoPaste 开发工作流定制 Trellis 三 Agenttrellis-research / trellis-implement / trellis-check的完整实践指南EcoPaste 开发工作流定制 Trellis 三 Agenttrellis research / trellis implement / trellis桌面应用EcoPaste 仓库的 Trellis Spec Bootstrap 实践以单 Agent 工作流从真实代码库构建编码规范EcoPaste 仓库的 Trellis Spec Bootstrap 实践以单 Agent 工作流从真实代码库构建编码规范 导读 本文围绕 EcoPaste桌面应用EcoPaste 仓库中的 trellis-implement 实现代理Trellis 多智能体工作流的职责、上下文加载协议与实战指南EcoPaste 仓库中的 trellis implement 实现代理Trellis 多智能体工作流的职责、上下文加载协议与实战指南 本篇技术指南围绕 Ec桌面应用上一篇高效解决ncm格式限制的开源音频转换工具NCMconverter全攻略下一篇NCMconverter解密网易云音乐加密文件的高效音频格式转换工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 EcoPaste 中的 Trellis Implement Agent：子代理驱动的 AI 编码实现规范与工作流解析
桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载在 EcoPaste 仓库的.trellis/目录下内置了一套名为 Trellis 的 AI 协作开发工作流系统。其中implement.md 定义了一个职责边界极其清晰的子代理——Implement Agent实现子代理它负责读取规格spec与任务产物task artifacts随后编写符合既有模式的代码并在提交前完成自检。本文将以其定义文档为主体结合 check.md、workflow.md 与真实任务归档完整拆解该子代理的上下文读取顺序、核心职责、禁止操作、执行工作流、代码规范与回报格式帮助读者理解主会话负责规划与提交、子代理负责实现与自检这一分工模式如何在 AI 编码通道channel runtime中落地。子代理的定位与启动方式从 implement.md 的文件头frontmatter可以看到它的四个元信息字段name: implement—— 子代理的唯一标识description—— Code implementation expert for the Trellis channel runtime. Understands specs and task artifacts, then implements features. No git commit allowed.一句话点明身份理解规格与任务产物、实现功能、但绝不允许 git commitprovider: claude—— 声明由 Claude 扮演该角色labels: [trellis, implement]—— 打上系统级标签便于被调度器检索。它的启动方式是通过trellis channel spawn --agent implement在 Trellis 通道运行时内被派发并在收件箱中收到一行Active task: path。这行路径就是它定位任务产物的入口所有需要读取的prd.md、design.md、implement.md、implement.jsonl都存放在该任务目录下。在 workflow.md 的 Phase 2.1Implement中主会话main session负责派发该子代理并有一条关键约束派发提示词必须以Active task: task path from task.py current开头之后才进入角色指令。同时存在子代理自我豁免规则——如果当前会话本身就是trellis-implement子代理则不得再派生另一个trellis-implement或trellis-check避免无限递归派发。这些约束保证了主会话派发、子代理执行的单向调用链。上下文读取顺序先清单、再需求、后设计Implement Agent 的核心工作前提是读懂上下文。定义文档明确要求按固定顺序读取以下文件task-path/implement.jsonl若存在——本轮任务精选的规格清单spec manifest其中列出的每个文件都必须读取task-path/prd.md——需求文档requirementstask-path/design.md若存在——技术设计文档task-path/implement.md若存在——执行计划.trellis/spec/——项目级开发规范只加载与即将编写的 diff 相关的部分。这里有一个容易混淆的点值得注意任务目录里名为implement.md的文件是执行计划execution plan与.trellis/agents/implement.md这个子代理定义文档是两个不同层级的产物。前者由主会话在规划阶段Phase 1写入后者是子代理自身的角色说明书。以归档任务 07-03-onboarding-admin-launch/implement.md 为真实样本可以看到一份合格执行计划的结构Checklist按可勾选条目列出Add Rust admin module → Addgeneral.run_as_adminto settings → Add command boundary → Wire startup → Wire onboarding UI → Update release note等实现步骤、Validation验证命令清单、Risky Files风险文件列表、Rollback回滚方案。这类文档正是 Implement Agent 在动手前必须理解清楚的对象。此外workflow.md 的 Phase 1.3 解释了implement.jsonl的产生方式它由主会话在规划阶段用python3 ./.trellis/scripts/task.py add-context name implement path reason逐条添加每行一个 JSON 对象{file: path, reason: why}路径以仓库根目录为基准。清单中只应包含 spec 文件与研究文件不应包含源码路径源码由子代理在实现阶段自行阅读也不能替代implement.md本身。核心职责理解、实现与自检定义文档用四条概括了子代理的本职Understand specs—— 阅读.trellis/spec/中与本任务相关的规范文件Understand task artifacts—— 阅读上文列出的任务产物Implement features—— 写出遵循规格与既有模式的代码Self-check—— 在回报之前对变更范围运行 lint 与类型检查。第 4 条自检是整个规范的关键设计子代理不是写完就交差而是要在自己负责的变更范围内先跑一遍项目自带的验证命令把结果写进回报。结合 .trellis/spec/index.md 中记录的 EcoPaste 验证基线这套自检命令在仓库中的实际形态为前端pnpm lintBiome与pnpm tscTypeScript 类型检查Rust 后端cd src-tauri cargo fmt cargo clippy -- -D warnings cargo test。在归档任务的执行计划 07-03-onboarding-admin-launch/implement.md 的 Validation 一节中可以看到这条基线的真实应用——cargo fmt、cargo test、cargo clippy -- -D warnings、pnpm lint、pnpm tsc均被列为已验证项而手动 Windows 验证UAC 弹窗、管理员进程重启等需要真实桌面会话的交互场景则被明确标注为未完成、待人工补测。这印证了自动化验证 人工验证边界的实践子代理能跑的命令必须跑跑不了的场景必须如实标注而不是假报通过。禁止操作提交权与实现权的分离Implement Agent 的定义文档用独立章节列出了一条不可逾越的红线git commitgit pushgit merge理由被明确写在文档中The supervising main session owns commits. Report what changed; do not commit on its behalf.监督方主会话拥有提交权只回报变更不得代提交。这是一套刻意设计的权限隔离子代理只能写代码、跑验证、写回报永远不能触碰 git 写操作。主会话在收到回报后会依据 workflow.md 的 Phase 3.4 负责批量提交且明令禁止git commit --amend要求按工作提交 → 归档提交 → 日志提交的三段式顺序执行。同一设计也完整复刻在兄弟子代理 check.md 的定义中——Check Agent 同样被禁止 commit/push/merge只能审查、自行修复机械性问题并回报。这种写操作收敛到主会话的模式既保证了 git 历史的一致性也让子代理可以放心地改代码而不必担心越权。五步工作流从读规格到回报结果Implement Agent 的执行流程被规范为五个有序步骤读规格—— 依据任务类型读取implement.jsonl中列出的规格文件若存在读任务产物—— 依次读取任务的prd.md、design.md若存在、implement.md若存在实现功能—— 遵循规格与既有代码模式编写代码自检—— 对变更范围运行项目的 lint 与类型检查回报—— 将改动文件、关键决策、验证结果回报给通道channel。这五步与 workflow.md 中的 Phase 2.1 / 2.2 严格对应主会话在 Phase 2.1 派发 implement 子代理随后在 Phase 2.2 派发 check 子代理做质量复核两者交替直至绿灯lint / typecheck / 测试全部通过。子代理完成实现后主会话还会触发一轮全范围full-scope终检——用python3 ./.trellis/scripts/get_context.py --mode packages列出所有受影响的包逐一加载各包 spec 索引中的 Quality Check 小节以捕获跨层/跨包问题。代码规范克制与聚焦定义文档对代码质量提出了四条务实要求Follow existing code patterns—— 跟随既有代码模式不另起炉灶Dont add unnecessary abstractions—— 不添加不必要的抽象层Only do what the PRD asks for; no speculative scope expansion—— 只做 PRD 要求的事不做推测性的范围扩张Surface uncertainty back to the channel rather than guessing—— 遇到不确定时向通道反馈而不是猜测。不做过度的范围扩张与有疑问先反馈这两条实际上是在给子代理划定探索半径它可以自由阅读.trellis/spec/中与本次 diff 相关的文件但不允许顺手重构无关模块或擅自扩大功能面。这与 .trellis/spec/index.md 中仅支持 macOS 与 Windows 两个#[cfg]分支、无 Linux 目标等项目级约束相辅相成共同保证了子代理产出的 diff 边界清晰、可审查。回报格式结构化、可追踪实现完成后子代理必须按固定模板回报共四段Files Modified—— 每个改动文件一行附一句话说明Implementation Summary—— 实现步骤编号列表Verification Results—— Lint 与 TypeCheck 各自标注pass | fail | skipped reasonOpen Questions—— 遗留疑问若无则省略该段。这套模板的设计意图很明显让主会话在收到回报后能立刻判断改了什么、为什么这样改、验证是否通过、还有什么悬而未决。其中skipped reason的显式标注尤其重要——正如归档任务 07-03-onboarding-admin-launch/implement.md 中Automated checks were rerun ... Manual UAC and Task Scheduler behavior still needs an interactive Windows desktop session的表述所示凡是环境不允许跑的验证都必须写明原因并移交人工而非含糊带过。与 Check Agent 的分工协同Implement Agent 并非孤军作战它与 .trellis/agents/check.md 定义的 Check Agent 构成实现 → 审查的接力闭环。两者的设计几乎镜像对称维度Implement AgentCheck Agent启动方式trellis channel spawn --agent implementtrellis channel spawn --agent check上下文入口Active task: pathActive task: path读取顺序implement.jsonl→prd.md→design.md→implement.md→.trellis/spec/check.jsonl→prd.md→design.md→implement.md→.trellis/spec/核心动作读规格、写代码、自检lint typecheckgit diff取 diff、对照任务产物与规格审查、机械问题就地修复、跑验证禁止操作commit / push / mergecommit / push / merge回报模板Implementation CompleteSelf-Check CompleteCheck Agent 的审查报告要求给出带file:line引用的具体发现并明确区分已修复与未修复移交主会话。两者都由主会话在 workflow.md 的[workflow-state:in_progress]阶段统一调度且共享子代理禁止再派生同侪子代理的豁免规则。这套分工把写代码和审代码的角色彻底分离避免了同一代理既当运动员又当裁判员的盲区。小结EcoPaste 仓库中的 implement.md 提供了一份可复用的 AI 实现子代理规范模板。它的核心价值可以概括为三点其一用严格的上下文读取顺序implement.jsonl→prd.md→design.md→implement.md→.trellis/spec/保证子代理在动手前掌握全部必要信息其二用git 写操作一律禁止的红线实现实现权与提交权的分离其三用结构化的回报模板Files Modified / Implementation Summary / Verification Results / Open Questions让验证结果可追踪、遗留问题不沉没。配合 workflow.md 的派发协议、check.md 的审查接力以及.trellis/tasks/下真实任务产物的佐证这套机制构成了一个主会话规划 子代理实现/自检 主会话提交的完整 AI 协作闭环可作为其他希望引入 AI 编码通道的项目直接参考的设计蓝本。赞分享桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载相关推荐EcoPaste 开发工作流定制 Trellis 三 Agenttrellis-research / trellis-implement / trellis-check的完整实践指南EcoPaste 开发工作流定制 Trellis 三 Agenttrellis research / trellis implement / trellis桌面应用EcoPaste 仓库的 Trellis Spec Bootstrap 实践以单 Agent 工作流从真实代码库构建编码规范EcoPaste 仓库的 Trellis Spec Bootstrap 实践以单 Agent 工作流从真实代码库构建编码规范 导读 本文围绕 EcoPaste桌面应用EcoPaste 仓库中的 trellis-implement 实现代理Trellis 多智能体工作流的职责、上下文加载协议与实战指南EcoPaste 仓库中的 trellis implement 实现代理Trellis 多智能体工作流的职责、上下文加载协议与实战指南 本篇技术指南围绕 Ec桌面应用上一篇高效解决ncm格式限制的开源音频转换工具NCMconverter全攻略下一篇NCMconverter解密网易云音乐加密文件的高效音频格式转换工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考