ccoalm/ccl-skills / skills/platform-service-connectivity
platform-service-connectivity
Verified服务互通 / service mesh / service discovery / mTLS / retry / timeout / circuit breaker / lane routing → design or debug how one request safely reaches another service across environments, mesh, clients, HTTP/RPC, and queues.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 25.9 KB |
| agents/openai.yaml | config | 280 B |
| references/dual-sidecar-and-traffic-config-center.md | markdown | 6.2 KB |
| references/framework-middleware.md | markdown | 5.5 KB |
| references/grpc-authority-workaround.md | markdown | 4.6 KB |
| references/http-response-envelope-contract.md | markdown | 1.7 KB |
| references/mesh-architecture.md | markdown | 9.6 KB |
| references/multi-env-routing.md | markdown | 6.2 KB |
| references/protobuf-http-contract-signals.md | markdown | 7.4 KB |
| references/retry-timeout-circuit-breaker.md | markdown | 12.8 KB |
| references/rpc-framework-recipe.md | markdown | 65.8 KB |
| references/service-discovery-choice.md | markdown | 9.6 KB |
| references/service-discovery-migration-playbook.md | markdown | 11.1 KB |
| references/service-discovery-recipe.md | markdown | 7.3 KB |
references/http-response-envelope-contract.md
View on GitHub# HTTP Response Envelope Contract
The cross-stack contract for the JSON business-response shape a backend returns and its clients parse. Owned here alongside the request-side base struct (`rpc-framework-recipe.md`) and the wire-format gate (`protobuf-http-contract-signals.md`) because it is shared across the Go, Python, web, mini-program, and testing skills — each points here and adds only its stack-specific verb (define / implement / consume / assert). Do not restate this policy per stack.
## Canonical envelope
- The canonical JSON business envelope is `code`, `message`, and `data`. `data` is the typed business data model for that operation.
- It is defined in the shared contract source, not invented per handler, route, or client.
## Adoption & migration
- New services and service-level envelope migrations use the canonical `code` / `message` / `data` envelope.
- A new route inside an existing service follows that service's already-shipped envelope until a consumer-migration decision adopts `code` / `message` / `data` for the service.
- An existing surface with a different shipped envelope preserves current behavior until a migration decision exists.
## Surfaces that are not the JSON envelope
Binary protobuf, streaming, file/download, redirect, healthcheck, and externally dictated callback / standard-protocol responses record, implement, and assert their own response contract instead of pretending to use the JSON envelope.
## Anti-patterns (when the canonical JSON envelope applies)
- Do not invent alternate or per-handler / per-route top-level business response shapes.
- Do not duplicate the common envelope fields across clients, or scatter duplicate envelope parsing.
- Do not place business fields outside `data`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |