ECShopX已配置AI Agent辅助开发
商派ECShopX开源商城发布后，为了提高开发者的开发效率，商派进行了「系统AI友好性」的能力提升，针对Cursor编码环境配置了Agent分层角色（规划/编排/执行与TDD（tdd-guard）钩子，让协作过程有统一节奏：先产出带验收与测试用例的计划，再按红绿重构实现，减少「直接改代码却不可测」的漂移。
基于 AI Agent 规则与 TDD 的使用说明
1 配置入口与优先级
| 位置 | 作用 |
|---|---|
| ECShopX/.cursor/rules/*.mdc | 始终生效的规则：`index`→`agent-triggers`→`workflow`→`tdd-guard`（优先级1~4） |
| ECShopX/.cursor/agents/*.md | 各子Agent的详细职责与输出约定（如 `planner.md`） |
| ECShopX/.cursor/hooks.json | 将Cursor事件转发`tdd-guard`CLI，在Edit/Write等操作前做TDD校验 |
2 Agent 体系（「技能」如何落地）
规则将能力拆成多层角色，通过 `@角色名` 或自然语言关键词切换意图；执行层任务在约定中应通过 `mcp_task` + `subagent_type` 委派，避免在当前会话里「一人分饰多角」。
规划层
Planner — 访谈、研究、强制咨询Advisor，产出`.tasks/plans/`
Advisor — 计划前风险与遗漏分析，只读、不改文件
Reviewer — 审查计划质量，返回`[OKAY]`/`[REJECT]`
编排层
Orchestrator — 用户确认「开始执行」后读计划、拆TODO、委派Developer/Architect/Explore，跑验证、维护Notepad
执行层
Developer — TDD实现，配合tdd-guard
Architect — 架构咨询，只读
Explore/Librarian — 代码探索/文档检索
3 工作流程速览
规划阶段
01 Planner访谈并研究代码库
02 强制Advisor评审后再写计划
03 生成`.tasks/plans/{name}.md`
04 可选Reviewer审查计划
✓ 用户审核并通过测试用例清单
执行阶段
01 Orchestrator读取计划与TODO
02 通过mcp_task委派Developer
03 phpunit零错误、全通过
4 TDD 机制与 tdd-guard
RED
每次只增加一个失败测试
GREEN
最小实现使当前测试通过
REFACTOR
仅在测试全绿时重构
Developer 的 TDD 要点
- RED：每次只增加一个失败测试，并保留失败证据
- GREEN：最小实现使当前测试通过
- REFACTOR：仅在测试全绿时重构，并持续跑测试
5 实例说明：从需求到一测一实现
场景
为「订单备注」增加接口能力——已登录用户可为自己名下某笔订单设置一段纯文本备注，长度不超过500字；非法订单ID或越权访问返回约定错误码。
对话示例
YOU
@planner 需求：为订单备注增加API…
AGENT
正在委派Explore定位Order相关路由…
ADVISOR
计划已生成，等待确认…
6 快速对照：你要做什么时该怎么做
新需求或改需求
走Planner → 计划含验收与测试用例 → 用户确认 → Orchestrator执行
只想改代码
仍应先有对应计划与用例约定（规则要求「无例外先规划」）
写PHP/API实现
Developer角色 + TDD；接受tdd-guard拦截并按reason调整
查代码/查文档
通过委派Explore/Librarian，而非在Planner/Orchestrator会话里自己搜遍全库
沪公网安备31010402010179号
沪ICP备2023003282号-38
