用途
jp-executor 用于在代码库中直接实施 Juspay 支付集成。它由上游规划产物驱动,读取 {doc_workspace}(即 {project-root}/docs/juspay/)中的三份文件:jp-prd PRD、jp-architecture 设计,以及该设计的 task-checklist.md。技能会按依赖顺序遍历清单,逐项实现,并在过程中把每个任务的状态写回清单,最后将摘要写回 {doc_workspace}。
主要能力与约定
- 文档实证(Doc-grounding):实施时通过 docs-mcp 重新获取架构文档中记录的权威 Juspay 文档页面,以确认方法/类/字段的准确名称,绝不凭记忆编码。
- SDK/headless 硬门控:在会话内获取到某支付方式的 process payload 页面并掌握其确切请求结构之前,不编写该方式的客户端支付代码。
- 密钥边界:凭证(API 密钥、webhook 认证)只存在于内存和 .env/密钥存储中,绝不写入 PRD、架构文档、日志或命令输出。
- 可调试默认:提供方/API 失败时默认保留完整提供方错误体用于日志/内部处理(受密钥/PAN 脱敏约束),而非折叠为通用消息。
- 工作区:从上游技能读取 prd.md、architecture.md、task-checklist.md;把集成代码写入用户代码库;随进度更新清单中的任务状态;将摘要写回 {doc_workspace}。分仓库运行时会读取传入的 handoff-<this_side>.md(若存在),并写出可移植的 handoff-<other_side>.md。
- 无自有配置:无设置文件、无语言/名称解析;只读取用户仓库和上游产物。
- 强制生产:始终以生产环境为目标,不询问环境、不提供沙盒。仅当用户明确且主动要求时才使用非生产环境。密钥类型/阶段与所配置主机保持一致。
- 分仓库感知:只构建 side ∈ {this_side, shared} 的任务;other_side 任务不在本侧实现,而是带入 handoff-<other_side>.md 交给另一仓库的智能体。若存在传入的 handoff-<this_side>.md,则按该契约构建本侧并验证一致性。
使用方式
激活时,技能会简要说明自身定位(依据 jp-prd PRD 与 jp-architecture 设计实施 Juspay 集成、无设置文件),随后加载 ./steps/step-01-init.md 作为入口门控。执行链如下:
- step-01-init.md — 硬门控(要求架构与任务清单),解析清单为队列,重新扫描代码库,拾取 juspay-mcp 模式。(始终)
- step-02-credentials.md — 凭证写入 .env(通过 juspay-mcp 或手动面板开通)。(按需适配)
- step-03-core.md — 重新获取文档、校验层(若有受约束字段)、安装 SDK、核心集成 + 订单状态对账。(始终)
- step-04-webhook.md — webhook 处理器(签名 + 幂等)。(仅当存在 webhook 任务)
- step-05-data-model.md — 订单/支付数据模型。(仅当存在数据库任务)
- step-06-native-setup.md — 移动原生 SDK 设置。(仅原生界面)
- step-07-portal-config.md — 面板配置(webhook/返回 URL),含导航路径与深链。(仅当存在手动面板任务)
- step-08-test.md — 最小活性冒烟,随后交给 jp-validate 进行充分、贴合技术栈的测试。(仅当存在测试任务)
- step-09-summary.md — 持久化集成摘要;最终确定清单状态。(始终)
步骤是条件性的。每个非通用步骤开头都有 APPLICABILITY 门控,当 task-checklist.md(权威)和 architecture.md 中不含该类工作时自动跳过——无 webhook 任务则无 webhook 处理器;Web/API 界面则无原生设置;面板无需设置则无门户步骤。执行器只做本次集成所需的事,绝不制造集成不需要的 webhook/数据库/原生/门户工作。分仓库运行中,“具有 X 任务”指本侧(side ∈ {this_side, shared})的 X 任务;other_side 任务在 step 1 已标记跳过,不会在此触发任何步骤。
这是行动导向而非引导式的:执行实施,但在风险/外部操作前会设置检查点(凭证开通、数据库架构变更、门户配置、启动服务器/测试)。
juspay-mcp 受认证保护,并非每位开发者都有面板访问权限;访问流程(申请访问 → 登录或手动问答)与来源/复用规则见 references/juspay-mcp.md。所有来自 juspay-mcp 的数据都有手动输入回退,流程不会因此阻塞。
适用场景
需要在代码库中落地 Juspay 支付集成,且已具备 jp-prd PRD 与 jp-architecture 设计及任务清单时使用。适用于单一仓库或分仓库场景(分仓库时处理本侧与共享任务,并进行交接)。
限制
- 需要上游架构文档与任务清单作为硬门控输入,缺失时无法推进。
- 不提供自有配置,不解析语言/名称。
- 强制面向生产环境,默认不提供沙盒。
- 仅构建本侧与共享任务,other_side 任务由另一仓库智能体处理。
- 充分测试由独立的 jp-validate 技能负责,本执行器只做活性冒烟。
- 关于具体收费、价格、平台支持范围等信息,资料中暂未提供。