用途
JP Architecture 用于为 Juspay 支付集成设计架构。它把 Juspay 集成 PRD 转化为全面、有文档依据的架构决策，通过协作式、分步骤的探索完成，从而让 jp-executor（以及任何 AI 智能体）能够一致地实现集成。
角色定位
该技能扮演集成架构师，与用户作为同行协作。技能提供结构化思维和 Juspay 集成知识；用户提供领域专业知识和产品上下文。决策由双方共同做出，并基于抓取的文档，而不是凭记忆断言。
主要能力
- 将 Juspay 集成 PRD 转化为架构决策，产出 architecture.md 和 task-checklist.md。
- 文档依据（Doc-grounding）：Juspay 产品/API/SDK 事实来自 docs-mcp-server（见 references/juspay-docs-mcp.md）或用户，绝不来自训练数据；架构文档中需引用来源 URL。
- 产品目录（products/）：非权威的定位目录，按产品提供“它是什么 / 何时推荐 / 关键概念 / 意图信号”，用于所选产品的概念/平台，需对照 docs-mcp 确认 slug/形态/平台。
- 实时商户数据（juspay-mcp）：可选且受认证保护，见 references/juspay-mcp.md。复用 PRD/.decision-log.md 已记录的模式和值；仅对本技能新需要的读取数据（webhook/通用设置、集成阶段）运行访问流程。绝不阻塞。凭据配置保留在 jp-executor；机密绝不进入本文档。
- 工作区：{doc_workspace} 为 {project-root}/docs/juspay/（不存在则创建）。技能在此读取 prd.md（来自 jp-prd），并写出 architecture.md 和 task-checklist.md。jp-executor 读取全部三者。在分离仓库运行中，它还可能读取传入的 handoff-<this_side>.md；可移植的 handoff-<other_side>.md 稍后由 jp-executor 生成。
- 无自有配置：没有设置文件，没有语言/名称解析。技能只读取用户输入（其仓库、其指向的文档）和 {doc_workspace} 中的产物。
- 强制生产环境：始终面向生产环境设计。不询问使用哪个环境，也不把沙箱与生产作为选项呈现；仅当用户明确且未受提示地要求时才切换到非生产环境（见 steps/step-04-decisions.md）。
- 分离仓库感知：前端和后端可能位于不同仓库。复用 jp-prd 记录的 topology/this_side/other_side；设计完整集成，但按端划分 task-checklist，并为接缝编写跨端契约（Cross-Side Contract）。如果存在传入的 handoff-<this_side>.md，则据此锁定契约。见 references/split-integration.md。
使用方式
工作流采用微文件架构以实现有纪律的执行：
- 每一步是自包含文件，内嵌规则。
- 按顺序推进，每步由用户控制。
- 文档状态通过 frontmatter（stepsCompleted）跟踪。
- 通过对话追加式构建文档。
- 如果当前步骤文件指示用户必须批准并表明继续，则绝不进入下一步骤文件。
激活时：简要向用户说明该技能把 Juspay 集成 PRD 转化为架构设计。提及在任何决策点，用户都可以要求更深入探索（内联高级引导）或从多个视角（安全 / 运维 / 开发者体验）权衡。运行时提供原生选择/选择/问题 UI 时优先使用；有原生 UI 时不要用手写的 A / P / C 文本模拟菜单。没有设置文件，也没有脚本需要运行。
执行：完整阅读并遵循 ./steps/step-01-init.md 开始工作流。注意：输入文档发现（jp-prd 的 PRD 为必需）和所有初始化协议在 step-01-init.md 中处理。
约定
- 裸路径（如 steps/step-01-init.md）从技能根目录解析。
- {skill-root} 解析为该技能安装目录。
- 以 {project-root} 为前缀的路径从项目工作目录解析。
适用场景
适用于需要为 Juspay 支付集成进行架构设计、并希望产出有文档依据的架构决策和任务清单的场景，尤其是前后端分离仓库的集成设计。
限制
- 所有 Juspay 产品/API/SDK 事实必须来自 docs-mcp-server 或用户，不能来自训练数据。
- 实时商户数据访问为可选且受认证保护，绝不阻塞流程。
- 凭据配置不在本技能内，机密不得进入架构文档。
- 始终面向生产环境设计，除非用户明确要求切换。
- 关于收费、价格、平台支持范围等具体信息，资料中暂未提供。