it235/multica-best-practices

multica-artifact-cicd-sync

CI/CD 产物编排：G2 PASS 且代码已 push 后调用 multica-platform-jenkins 触发 dev/sit 构建，回写 JIRA 并回传部署 URL。Python 实现，Windows / Linux 通用。

Source text: Chinese

multica-artifact-design-sync

把技术设计文档落地到 Confluence（默认父页面 <CONFLUENCE_DESIGN_PAGE_ID>）并回写 JIRA 链接。用于 @Architect 发布设计，供实现与测试下游消费。

Source text: Chinese

multica-artifact-req-sync

PRD 产物编排：调用 multica-platform-confluence + multica-platform-jira 落地需求。用于 @ProductManager 上传 PRD、回传链接。

Source text: Chinese

multica-manage-skills

查询已部署的 multica 平台 API，获取 workspace / agent 统计信息（agent 运行次数、30 天活动明细、各 workspace 汇总）。当用户需要查 multica 数据（如“每个 workspace 的 agent 运行次数”“workspace 统计”“multica 接口数据”），或访问 <MULTICA_API_URL> 的 API 信息时使用。脚本为纯标准库 Python，无需安装依赖。

Source text: Chinese

multica-platform-confluence

Confluence 读写：页面拉取、PRD HTML 创建、Markdown 设计发布。平台 skill，与 JIRA 解耦；由产物编排 skill 调用。

Source text: Chinese

multica-platform-jenkins

Jenkins 读写：触发带参构建、轮询状态、取控制台日志。平台 skill，凭据共用域账号。Python 实现，Windows / Linux 通用。

Source text: Chinese

multica-platform-jira

JIRA 读写：Issue 查询、Confluence 链接解析、Story 创建、流转、排期、描述回写、钉钉。平台 skill，与 Confluence 解耦。

Source text: Chinese

multica-requirement-analysis

把 Issue / 诉求结构化为带编号的 PRD 内容。用于 @ProductManager 需求澄清、范围确认、验收标准定义；结构就绪后交 multica-artifact-req-sync 落地。

Source text: Chinese

multica-review-architect

架构设计专属评审框架。由 ArchReviewer 调用，对 Architect 产出的技术架构设计做专业分析（合理性/扩展性/验收对齐/技术风险），输出 PASS/FAIL 与修改清单，汇报 Leader。

Source text: Chinese

multica-review-backend

后端实现专属评审框架。由 BackendReviewer 调用，对 BackendDev 产出的 API 契约与后端实现做专业分析（契约质量/设计吻合/错误处理/单测充分性/验收对照），输出 PASS/FAIL 与修改清单，汇报 Leader。

Source text: Chinese

multica-review-product

需求/PRD 专属评审框架。由 ProductReviewer 调用，对 ProductManager 产出的 PRD 做专业分析（范围清晰/目标明确/验收可测/约束完备/待确认项），输出 PASS/FAIL 与修改清单，汇报 Leader。

Source text: Chinese

multica-review-test

测试产物专属评审框架。由 TestReviewer 调用，对 Tester 产出的用例/测试报告/覆盖率文档做专业分析（覆盖深度/验收对应/覆盖率合理/结论真实/契约一致），输出 PASS/FAIL 与修改清单，汇报 Leader。

Source text: Chinese

multica-technical-design

基于 PRD 与现有代码产出最小技术方案。用于 @Architect 架构分析、影响评估、实现方案设计；草稿就绪后交 multica-artifact-design-sync 落地。

Source text: Chinese

multica-test-automation

Tester T3 自动化：G2.5 部署环境就绪后，用 Apifox CLI 执行场景用例。Python 封装，Windows / Linux 通用。

Source text: Chinese

multica-test-design

测试设计功能：基于需求 / 设计 / API 契约产出功能用例与接口用例，自动化优先执行，出具逐条对照验收标准的测试报告。用于功能用例 / 接口测试用例 / 测试执行 / 测试报告。

Source text: Chinese

multica-review-architect

Architecture-design dedicated review framework. Called by ArchReviewer to professionally analyze Architect's technical design (soundness/extensibility/acceptance alignment/tech risk), output PASS/FAIL + fix list, report to Leader.

multica-review-backend

Backend-implementation dedicated review framework. Called by BackendReviewer to professionally analyze BackendDev's API contract & implementation (contract quality/design fit/error handling/unit-test sufficiency/acceptance mapping), output PASS/FAIL + fix…

multica-review-designer

UI-design dedicated review framework. Called by DesignReviewer to professionally analyze Designer's UI/interaction design (interaction soundness/accessibility/design-system consistency/edge states), output PASS/FAIL + fix list, report to Leader.

multica-review-frontend

Frontend-implementation dedicated review framework. Called by FrontendReviewer to professionally analyze FrontendDev's output (UI/API-contract fit/component quality/unit-test sufficiency/acceptance mapping), output PASS/FAIL + fix list, report to Leader.

multica-review-product

Requirements/PRD dedicated review framework. Called by ProductReviewer to professionally analyze ProductManager's PRD (scope clear/goal explicit/acceptance testable/constraints complete/open items), output PASS/FAIL + fix list, report to Leader.

multica-review-test

Test-artifact dedicated review framework. Called by TestReviewer to professionally analyze Tester's cases/report/coverage doc (coverage depth/acceptance mapping/coverage reasonableness/conclusion truth/contract consistency), output PASS/FAIL + fix list,…

multica-review-designer

UI 设计专属评审框架。由 DesignReviewer 调用，对 Designer 产出的 UI/交互设计做专业分析（交互合理性/可访问性/设计系统一致/边界态），输出 PASS/FAIL 与修改清单，汇报 Leader。

Source text: Chinese

multica-review-frontend

前端实现专属评审框架。由 FrontendReviewer 调用，对 FrontendDev 产出做专业分析（UI/API 契约吻合度/组件质量/单测充分性/验收对照），输出 PASS/FAIL 与修改清单，汇报 Leader。

Source text: Chinese

multica-platform-jenkins

Platform-layer skill (placeholder shell): read/write capability for CI/CD systems (Jenkins-class) — trigger parameterized builds, poll status, fetch console logs. Parameters are auto-discovered; never hardcode. Credentials injected via runtime env. Concrete…

multica-artifact-cicd-sync

CI/CD artifact-orchestration skill (placeholder shell): after G2 PASS and code push, call the underlying CI/CD platform skill to trigger dev/sit builds, write back to the Issue, and return the deploy URL. Parameters auto-discovered from the CI API; the…

multica-platform-confluence

Platform-layer skill (placeholder shell): read/write capability for Confluence / Wiki-class systems — pull existing pages for Agents to consume, land PRD / design artifacts and return a stable page link. Decoupled from the Issue system; called by…

multica-platform-jira

Platform-layer skill (placeholder shell): read/write capability for Issue-tracking systems (JIRA-class) — Issue query, upstream-Wiki-link parsing, Story creation, transition, scheduling, description write-back, notification. Decoupled from the Wiki platform;…

multica-test-automation

Test-automation skill (placeholder shell): Tester phase-3 automation — after G2.5 the deploy environment is ready, run the team's automation tool against the scenario cases and produce G3 input. Concrete tool (Apifox / Postman / Playwright / pytest / etc.)…

multica-artifact-api-sync

Land API contract artifacts to the API collaboration platform (default Apifox). Used by @BackendDev to upload API contract for downstream frontend / test consumption. Swappable platform.

multica-artifact-design-sync

Land technical design artifacts to the code repo or knowledge platform (default Git repo / Confluence). Used by @Architect to upload technical design for downstream implementation and test consumption. Swappable platform.

multica-artifact-req-sync

Land product requirement / PRD artifacts to the requirement knowledge platform (default Confluence). Used by @ProductManager to upload PRD and return a link for downstream design / dev / test consumption. Swappable platform.

multica-artifact-test-sync

Land test case / report artifacts to the case-management platform (default local XMind → Jira). Used by @Tester to upload cases and return a link for downstream acceptance consumption. Swappable platform.

multica-artifact-ui-sync

Land UI / interaction design artifacts to the design collaboration platform (default Figma). Used by @Designer to upload visuals and return a stable link for downstream frontend consumption. Swappable platform.

multica-artifact-api-sync

把 API 接口文档产物对接到接口协作平台（默认 Apifox）。用于 @BackendDev 上传 API 契约，供前端 / 测试下游消费。平台可替换。

Source text: Chinese

multica-artifact-test-sync

把测试用例 / 测试报告产物对接到用例管理平台（默认本地 XMind 转 Jira）。用于 @Tester 上传用例、回传链接，供验收下游消费。平台可替换。

Source text: Chinese

multica-artifact-ui-sync

把 UI / 交互设计产物对接到设计协作平台（默认 Figma）。用于 @Designer 上传视觉稿、取回链接与标注，供前端下游消费。平台可替换。

Source text: Chinese

multica-gate-setup

Integrate CI hard gates into the target repository and make gatekeeping read the CI verdict. Used for deploying gates, reading check-runs for G2, and falling back to soft gates when there's no CI.

multica-implementation

Implement an approved technical plan with minimal unnecessary changes. Used for coding, adding tests, and running verification.

multica-requirement-analysis

Turn an Issue into a clear, actionable engineering task. Used for requirement clarification, scope confirmation, and acceptance-criteria definition.

multica-technical-design

Produce a minimal technical plan based on the existing code. Used for architecture analysis, impact assessment, and implementation-plan design.