---
title: 配置AI Agent辅助开发能力，商派ECShopX开源商城开发效率拉满！
description: 文本抽取：知识库/06-人工智能与AI/配置AI Agent辅助开发能力，商派ECShopX开源商城开发效率拉满！
updated: 2026-11-04
tags: [原始文档, 抽取, 知识库]
source: 知识库/06-人工智能与AI/配置AI Agent辅助开发能力，商派ECShopX开源商城开发效率拉满！
source_type: txt
source_hash: 7d157b1115a2
extracted_at: 2026-11-04
quality: ok
---

---
source: 知识库/06-人工智能与AI/配置AI Agent辅助开发能力，商派ECShopX开源商城开发效率拉满！.pdf
type: pdf
size_kb: 4094
category: 06-人工智能与AI
quality: ok
---

<a id="page-1"></a>## Page 1
配置AI Agent辅助开发能⼒，商派ECShopX开源商城开发效率拉
满！
原创 市场 商派 2026年4⽉1⽇ 19:21 上海
商派ECShopX开源商城AIAgent辅助开发
开发助⼿
AlAgent
商品管理
智能代码⽣成
订单数据分析
⾃动调程优化
API CODE
Shopex:Al
AlPowerstheFutureofBusiness
【开源产品】 企业级ECShopX交易系统与ONEX OMS订单管理系统免费开源！100%⽆加密、可商
⽤
ECShopX已配置AI Agent辅助开发
商派ECShopX开源商城发布后，为了提⾼开发者的开发效率，商派进⾏了“系统AI友好性”的能⼒
提升，针对Cursor 编码环境配置了Agent分层⻆⾊（规划/编排/执⾏与TDD（tdd-guard）钩
⼦，让协作过程有统⼀节奏：先产出带验收与测试⽤例的计划，再按红绿重构实现，减少「直接
改代码却不可测」的漂移。
基于 AI Agent 规则与 TDD（tdd-guard）的使⽤说明
1. 配置⼊⼝与优先级
位置 作⽤
始终⽣效的规则：index→agent-triggers→wo
ECShopX/.cursor/rules/*.mdc
rkflow→tdd-guard（优先级1~4）
各⼦Agent的详细职责与输出约定（如 planner.m
ECShopX/.cursor/agents/*.md
d）
ECShopX/.cursor/hooks.json + ho 将Cursor事件转发tdd-guard CLI，在Edit/Write
oks/cursor-adapter.js 等操作前做TDD校验
2. Agent 体系（「技能」如何落地）
规则将能⼒拆成多层⻆⾊，通过 @⻆⾊名 或⾃然语⾔关键词切换意图；执⾏层任务在约定中应通
过 mcp_task + subagent_type 委派，避免在当前会话⾥「⼀⼈分饰多⻆」。
层
⻆⾊ 要点
级
规
访谈、研究（委派 Explore/Librarian）、强制咨询 Advisor，产出 .tas
划 Planner
ks/plans/{name}.md；只动 .tasks/ 下⽂档，不写业务代码
层
规
划 Advisor 计划前⻛险与遗漏分析，只读、不改⽂件
层
规 Reviewer
划 （可选⾼精 审查计划质量，返回 [OKAY] / [REJECT]
层 度）
编
Orchestra ⽤户确认「开始执⾏」后读计划、拆 TODO、委派 Developer/Architec
排
tor t/Explore/Librarian，跑验证、维护 Notepad
层
执
⾏ Developer TDD 实现（配合 tdd-guard），遵守计划内已审核的测试⽤例
层
执
⾏ Architect 架构咨询，只读
层
执
Explore /
⾏ 代码探索 / ⽂档与最佳实践检索
Librarian
层
核⼼原则（摘⾃规则）：
先规划后执⾏
任何任务（含⼩修复）都需经 Planner 产出计划；规划者与执⾏者职责分离。
@<Agent名> 优先
⽤户显式指定⻆⾊时优先按该⻆⾊⾏事。
⼦任务必须委派
Explore、Librarian、Advisor、Reviewer、Developer 等对应⼯作应⽤ mcp_task 发起，并
在 prompt 中写清任务（可⽤下⽂ 6-Section 格式）。
3. ⼯作流程速览
3.1 规划阶段
1. Planner 访谈并研究代码库（通过委派 Explore/Librarian）。
2. 强制Advisor 评审后再写计划。
3. ⽣成 .tasks/plans/{name}.md ，其中必须包含 Acceptance & Test Cases：
WHEN/THEN 验收场景 + 由场景推导的测试⽤例（含边界）。
4. 可选：⾼精度模式下由 Reviewer 审查计划； [REJECT] 时 Planner 需改计划并再审直
⾄ [OKAY] 。
5. ⽤户审核并通过计划中的测试⽤例清单后，才允许进⼊执⾏阶段。
3.2 执⾏阶段
1. Orchestrator 读取同⼀ name 的计划与 TODO，可维
护 .tasks/boulder.json 与 .tasks/notepads/{plan-name}/ （ learnings.md 、
decisions.md 、 issues.md 、 problems.md 等，追加写⼊并带作者与时间戳）。
2. 通过 mcp_task 按 TODO 委派；委派 Developer 时 CONTEXT 须引⽤计划中 Acceptance &
Test Cases ⾥与本任务相关的条⽬。
3. 本项⽬验证
phpunit 零错误、全通过；必要时结合诊断读取变更⽂件⼈⼯核对。
3.3 委派⽤的 6-Section Prompt（Orchestrator → 执⾏层）
计划要求使⽤统⼀结构，便于落地与审计：
TASK
/ EXPECTED OUTCOME / REQUIRED TOOLS / MUST DO / MUST NOT DO / CONTEXT
Developer 的 MUST DO 中应包含：遵循 TDD 与 tdd-guard.mdc ；MUST NOT 中应包含：不得⽤
脚本或让⽤户⼿动改代码来绕过 tdd-guard。
4. TDD 机制与 tdd-guard
4.1 ⽬标
在 Edit / MultiEdit / Write 等写⽂件操作前拦截「跳过测试」或「⼀次改太多」等⾏为，引导 RED →
GREEN → REFACTOR。
4.2 运⾏⽅式
hooks.json
在 preToolUse （匹配Write|Edit|MultiEdit）、 beforeSubmitPrompt 、 sessionStart 时
执⾏： node .cursor/hooks/cursor-adapter.js 。
适配器
将 Cursor 的 payload 规范为 tdd-guard 所需字段，并在可能时把对已存在⽂件的 Write 转
为 Edit / MultiEdit ；最终调⽤ tdd-guard 可执⾏⽂件并将结果回传。
若返回 block（或 continue: false ），适配器以 退出码 2 表示拦截。
4.3 被拦截时 Agent 应怎么做
1. 阅读返回的 reason （含违规说明与建议的下⼀步）。
2. 在本会话内
按建议继续：例如只加最⼩实现、先 stub、先建空类再跑测试等。
3. 禁⽌
⽤ sed /重定向等脚本批量改受检⽂件，或让⽤户⼿动粘贴代码以绕过拦截。
4.4 Hook 不可⽤时的⾃律
若 tdd-guard 未安装、超时或报错：Developer 仍应按 同⼀套 TDD 纪律（⼀次⼀个失败测试、最⼩实
现、全绿再重构）⼯作，只是没有⾃动拦截。
4.5 Developer 的 TDD 要点
RED
每次只增加⼀个失败测试，并保留失败证据。
GREEN
最⼩实现使当前测试通过。
REFACTOR
仅在测试全绿时重构，并持续跑测试。
Planner 在 TODOs 中应对涉及实现与测试的任务 先列写测试（RED），再列实现（GREEN），与上述
顺序⼀致。
5. 实例说明：从需求到⼀测⼀实现
以下⽤虚构但贴近本仓库的场景串起整条链路，便于对照规则⽂件理解「先规划、再审测试⽤例、再执⾏」
的含义。
场景： 为「订单备注」增加接⼝能⼒——已登录⽤户可为⾃⼰名下某笔订单设置⼀段纯⽂本备注，⻓度不
超过 500 字；⾮法订单 ID 或越权访问返回约定错误码。
在 Cursor 中的具体操作示例
以下假定已⽤ Cursor 打开本仓库根⽬录（即包含 ECShopX/.cursor/ 的项⽬根），使规则与钩⼦对该
⼯作区⽣效。
⽤ @ 指定⻆⾊与上下⽂（与 agent-triggers.mdc ⼀致）：
写法 ⽤途
@planner 显式进⼊规划流程，先产出 .tasks/plans/...，不写业务代码。
@developer 按已确认计划做 TDD 实现。
@orchestrator 在你说「开始执⾏」后拆任务、委派、跟进验证。
@advisor / @rev
按需单独咨询顾问或审查（通常由 Planner 流程内委派）。
iewer 等
例如 @routes/...、@tests/...、.tasks/plans/order-note-api.md，把实
@ ⽂件或⽂件夹
现与验收上下⽂⼀并交给模型。
可照抄改写的对话示例：
1. 启动规划（Chat 输⼊框）
@planner 需求：为订单备注增加 API——已登录⽤户仅可更新本⼈订单备注，纯⽂本 ≤500
字，越权与⾮法订单 ID 返回约定错误码。请先委派 Explore 定位 Order 路由与服务类，
再经 Advisor，输出 .tasks/plans/order-note-api.md，含 Acceptance & Test
Cases 与测试⽤例清单；我确认⽤例后再进⼊执⾏。
2. 把计划⽂件拉进上下⽂后追问
@.tasks/plans/order-note-api.md 请根据其中「越权」相关⽤例，检查是否还缺边界
（如空备注、仅空格）；若缺则更新计划中的测试⽤例表。
3. 确认⽤例后，开始执⾏
@orchestrator 我已确认 order-note-api 计划中的测试⽤例清单。请读取同⼀计划拆
TODO，并委派 @developer：先按 TDD 实现「订单不属于当前⽤户则失败」这⼀条
（RED→GREEN），再扩展成功路径。
4. 在终端跑单测（路径按本机克隆位置调整）
./vendor/bin/phpunit --filter OrderNote
若 tdd-guard 拦截某次写⼊： 在同⼀ Chat 会话中根据提示继续，例如：
刚才的 Edit 被 tdd-guard 拦截。请阅读返回的 reason，只做最⼩改动满⾜当前⼀条失败
测试，不要⼀次改多个⽆关⽂件，不要⽤脚本批量替换源码。
避免新开对话导致丢失计划与钩⼦上下⽂；不要⽤外部脚本或⼿动粘贴⼤段代码绕过拦截。
1）规划（Planner）
⽤户描述需求后，Planner 通过委派 Explore 定位 Order 相关路由与服务类，必要时委派 Librarian
查框架约定。
强制
经 Advisor 审视范围与⻛险后，⽣成 .tasks/plans/order-note-api.md ，其
中 Acceptance & Test Cases ⾄少包含：
WHEN
合法⽤户更新本⼈订单备注 THEN 返回 200 且持久化成功；
WHEN
订单不属于当前⽤户 THEN 返回 403/业务错误码；
WHEN
备注超⻓或空串边界 THEN 校验与错误响应符合约定。
Planner 呈现测试⽤例清单，等待你确认后再进⼊执⾏。
2）可选⾼精度（Reviewer）
若开启⾼精度审查，Reviewer 对计划⽂档做 [OKAY] / [REJECT] ；被拒则 Planner 改计划后再
审。
3）执⾏（Orchestrator + Developer）
你说「开始执⾏」后，Orchestrator 读取同⼀计划中的 TODO，按依赖拆任务，并通
过 mcp_task 委派 Developer，prompt 采⽤ 6-Section，且在 CONTEXT 中引⽤计划⾥与本任
务对应的 验收场景与⽤例 ID。
Developer
严格 TDD：例如先写⼀条「越权访问应失败」的测试（RED），再写最⼩控制器/服务逻辑使该测试
通过（GREEN），再补「成功路径」测试并实现，最后在全部绿的前提下做⼩幅重构
（REFACTOR）。
若 tdd-guard 拦截某次 Edit/Write，根据返回的 reason 在本会话内缩⼩改动（如只补⼀个⽅
法、先通过当前单测），不要⽤脚本或让⽤户⼿动粘贴绕过。
4）收尾
运⾏ phpunit 全绿；Orchestrator/Developer 视需要在 .tasks/notepads/order-note-
api/ 追加决策与问题记录。
该实例对应规则中的 Planner → 计划含 Acceptance & Test Cases → ⽤户确认 → Orchestrator 委
派 → Developer 按 TDD 与 tdd-guard 实现；真实任务请始终以 .tasks/plans/{name}.md 与项
⽬代码为准。
6. 快速对照：你要做什么时该怎么做
场景 建议
新需求或改需
⾛ Planner → 计划含验收与测试⽤例 → ⽤户确认 → Orchestrator 执⾏
求
只想改代码 仍应先有对应计划与⽤例约定（规则要求「⽆例外先规划」）
写 PHP/API
Developer ⻆⾊ + TDD；接受 tdd-guard 拦截并按 reason 调整
实现
查代码 / 查⽂ 通过委派 Explore / Librarian，⽽⾮在 Planner/Orchestrator 会话⾥⾃⼰搜
档 遍全库代替委派
商派
商派ShopeX AI⸺全球品牌企业数智科技伙伴。为品牌企业提供⼀站式、⼀体化的全渠道…
1742篇原创内容
公众号
｜ShopeX商派品牌客户感谢信 >>
⼗五年的陪伴！ 商派喜获客户迪卡侬DECATHLON的感谢信
⾼难度项⽬顺利收官！⽴邦向商派发来感谢信！
「永盛⼯业品电商平台」成功上线，客户向商派发来感谢信！
齐⼼攻坚，能打硬仗！奈斯派索（Nespresso）向商派项⽬组发来感谢信
“背靠商派，深感踏实！”商派再获"佛罗伦萨⼩镇"发来的感谢信
DMS项⽬成功上线，知名家居品牌向商派发来感谢信
商派连续5年⽀持“Apple秋季新品发布会”，喜获苹果中国的感谢信
享誉全球的⾼端床垫品牌“丝涟Sealy”发来感谢信
Crocs卡骆驰OMS完美交付，商派喜获客户感谢信
商派正在服务众多全球知召品牌企业
Iululemon AIGLE @DECATHLON
INMOTION ARCTERYX DEPUIS1853
HM SMCP
ba&sh
ETA
crocs™ MassimoDutti Milano SANORO,MUE.CLALDIEPERLOT
VANS Lee Dickle: MARCJACOBS
"OFFTHEWALL"
eccO HLA EP YABNS&COLOBS GENTLEMONSTER CHARLES
海濯之冢
KEITH
tapestry UGG 4Columbia Lagardère
coscI|barespade|slarmirzeo Timberland LACOSTE TRAVELRETAIL
LVMH CHOWTAIFOOK
TIFFANY&CO.
aW
SALVINI
DIULA
周⼤福
MOẾTHENNESSY•IOUSVUTTON DanielWellington
⽼庙 COSTA 菜百⾸饰
TNY!!
COFFEE 亞⼀⾦店 CAIBAIJEWELRY CHAGEE
PHILIPS ZTE中兴 SUPOR Panasonic
苏泊尔
NESPRESSO
MOMA猛玛 Miele BOSCH B/S/H/
Nestle. REMYMARTIN
NWCRAMFAGNCOU
SHISEIDO 屈⾂⽒ DARLIE 菲婷丝 森糕菜 美宜佳（
好来
watsons finetoday
MARS FERRFRO JinKO Solar HONDA guanaitong溫
ROCHER
FrestondCompinatée 新⼤洲本⽥
soursiinybyneture
领取完整解决⽅案/课件
扫码咨询了解
服务热线：400-821-3016
商派官⽹：www.shopex.cn
商派开源：oss.shopex.cn
商派总部：徐汇区桂平路391号
商派 赞 分享 推荐 写留⾔