mcpField
J
jp-executor

jp-executor

github.com/juspay开发097 次安装4 周前更新
代码仓库

关于 jp-executor

jp-executor 是一项技能，可依据 PRD、架构设计和任务清单，在现有代码库中实现 Juspay 支付集成。它按依赖顺序执行任务，重新核对文档中的 API 细节，并记录进度。

主要功能

  1. 01按任务清单推进集成
  2. 02依据文档实现 API
  3. 03按需配置 Webhook 和数据库
  4. 04凭据与密钥处理
  5. 05拆分仓库任务交接
  6. 06集成状态与摘要跟踪

适用场景

  1. 01根据已确认的设计文档构建 Juspay 集成
  2. 02仅实现分配给当前仓库的后端或前端任务
  3. 03添加所需的 Webhook 或支付数据模型
  4. 04跟踪实现进度以便交接和审查

MCP 相关

它可通过 docs-mcp 获取权威 Juspay 文档，并通过 juspay-mcp 处理凭据配置或仪表板相关数据；两者均提供手动输入备选方式。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/juspay/merchant-skills --skill jp-executor

安装后在 Claude Code 中输入/jp-executor确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
integration-stage-tracking.md
juspay-docs-mcp.md
juspay-mcp.md
split-integration.md
steps/
step-01-init.md
step-02-credentials.md
step-03-core.md
step-04-webhook.md
step-05-data-model.md
step-06-native-setup.md
step-07-portal-config.md
step-08-test.md
step-09-summary.md

详细介绍

JP Executor

你将根据 {doc_workspace} 中的上游规划资料，直接在代码库中实现 Juspay 支付集成：包括 jp-prd PRD、jp-architecture 设计文档及其 task-checklist.md。你将按照依赖顺序逐项完成清单，所有代码、字段和方法名称都以重新获取的文档为依据（绝不依赖记忆），并在推进过程中回写每项任务的 status。

约定

  • 裸路径从技能根目录解析；{skill-root} 是此技能的安装目录；{project-root} 是项目工作目录。
  • 以文档为依据。 实施时，通过 docs-mcp 重新获取架构文档中记录的权威 Juspay 文档页面，以确认准确的方法、类和字段名称——绝不凭记忆编写代码。
  • SDK/无头模式硬性门槛。 在获取该支付方式的 process 负载页面并在本次会话中确认其准确请求结构之前，不得编写客户端支付方式代码。
  • 密钥边界。 凭据（API 密钥、Webhook 身份验证信息）只能保存在内存和 .env/密钥存储中——不得写入 PRD、架构文档、日志或命令输出。
  • 默认便于调试。 提供方/API 失败时，默认保留完整的提供方错误正文，供日志和内部处理使用（但须对密钥/PAN 进行脱敏），不得折叠成通用错误消息。
  • 工作区。 {doc_workspace} 为 {project-root}/docs/juspay/——从上游技能读取 prd.md、architecture.md 和 task-checklist.md；将集成代码写入用户的代码库，在推进过程中更新 task-checklist.md 中的任务 status，并将摘要写回 {doc_workspace}。在拆分仓库的运行中，还需读取传入的 handoff-<this_side>.md（如存在），并写入可移交的 handoff-<other_side>.md。
  • 不提供自有配置。 不使用设置文件，也不进行语言/名称解析；仅读取用户的仓库和上游资料。
  • 强制使用生产环境。 始终面向生产环境；不要询问要使用哪个环境，也不要提供沙盒环境。只有用户明确且主动要求时，才使用非生产环境。确保密钥类型/阶段与配置的主机一致（参见 steps/step-02-credentials.md）。
  • 支持拆分仓库。 仅构建 side ∈ {this_side, shared} 的任务；此处不实现 other_side 任务，而是将其写入 handoff-<other_side>.md，交由另一个仓库的 Agent 处理。如果存在传入的 handoff-<this_side>.md，则按其约定构建此侧并验证是否符合要求。参见 references/split-integration.md。
  • 阶段跟踪。 此技能负责 backend 和 frontend 漏斗阶段，并根据本次运行实际构建的内容确定阶段——通过 steps/step-01-init.md 标记为 started，通过 steps/step-09-summary.md 标记为终态，并调用 juspay_track_integration_stage（触发后即返回，不阻塞）。参见 references/integration-stage-tracking.md。

激活时

简要向用户说明：此技能根据 jp-prd PRD 和 jp-architecture 设计实现 Juspay 集成。此技能没有设置文件。然后加载 ./steps/step-01-init.md，该步骤会检查这些输入是否齐备。

执行

完整阅读并遵循：./steps/step-01-init.md。步骤链：

  1. step-01-init.md — 硬性门槛（必须提供架构和任务清单），解析清单 → 队列、重新扫描代码库、选择 juspay-mcp 模式。（始终执行）
  2. step-02-credentials.md — 将凭据写入 .env（通过 juspay-mcp 配置，或在控制面板中手动配置）。（根据所需内容调整）
  3. step-03-core.md — 重新获取文档、验证层（适用于受约束的字段）、安装 SDK、核心集成 + 订单状态对账。（始终执行）
  4. step-04-webhook.md — webhook 处理程序（签名 + 幂等性）。（仅当存在 webhook 任务时）
  5. step-05-data-model.md — 订单/支付架构。（仅当存在 db 任务时）
  6. step-06-native-setup.md — 移动端原生 SDK 设置。（仅适用于原生端）
  7. step-07-portal-config.md — 控制面板配置（webhook/返回 URL），包含导航路径 + 深层链接。（仅当存在 manual-dashboard 任务时）
  8. step-08-test.md — 最精简的存活性冒烟测试，然后交由 jp-validate 执行全面且适配技术栈的测试。（仅当存在 test 任务时）
  9. step-09-summary.md — 持久化集成摘要；完成清单状态。（始终执行）

全面的测试由专用的 jp-validate 技能负责（检测代码库的测试技术栈并复用该技术栈，按风险优先级进行支付测试，并编写 test-report.md）。此执行器会进行存活性冒烟测试并提供指引；构建完成后运行 jp-validate。

步骤按条件执行。 每个非通用步骤开头都有适用性检查，并且当 task-checklist.md（权威依据）和 architecture.md 中没有该类工作时会自行跳过——没有 webhook 任务 → 不创建 webhook 处理程序；Web/API 端 → 不进行原生端设置；无需在控制面板中设置任何内容 → 不执行控制面板步骤。执行器只做此集成所需的工作，绝不会凭空增加集成不需要的 webhook/DB/原生端/控制面板工作。在 split 运行中，“存在 X 任务”是指此侧的 X 任务（side ∈ {this_side, shared}）；other_side 任务已在步骤 1 中标记为 skipped，不会触发此处的步骤。

这是以行动为导向的流程，而非引导式流程：执行实现，但在高风险/外部操作前设置检查点（配置凭据、变更 DB 架构、配置控制面板、启动服务器/测试）。

juspay-mcp 有身份验证保护；并非每位开发者都能访问控制面板。访问流程（申请访问 → 登录或手动问答）以及来源/复用规则见 references/juspay-mcp.md。每项来自 juspay-mcp 的数据都有手动输入的备用方案，因此流程不会受阻。

评论

支持 Markdown