跳到正文
cccskills
免费在 GitHub 公开

arch

Navigate FlexPrice’s codebase using its architecture maps, dependency graphs, hotspot notes, and flow documents. Trace a feature across layers and async systems, assess likely change impact, and identify documentation that should be updated after structural edits.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

FlexPrice repo architecture — docs/ layering, deps, hotspots, flows, Graphify. Say arch, repo architecture, FLEXPRICE structure, onboarding codebase.

flexprice/flexprice星标 6,876(GitHub 6,876 + cccskills 0)

实测评分 未实测

查看安装方法

适用场景

  • Getting oriented in the FlexPrice codebase
  • Tracing a feature across code layers
  • Assessing impact before a refactor
  • Updating architecture notes after structural changes

包含的文件(1)

  • SKILL.md3.7 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

arch — repository architecture

Use when navigating cmd/, internal/, ent/ (billing, metering, Temporal, Kafka, integrations).

Other repos: repo-architecture-intelligence (~/.cursor/skills/repo-architecture-intelligence/SKILL.md).

Sibling skills: README (apitest, devenv, godev, openapi, pr, gh, compose).

Canonical documentation map

DocPurpose
docs/REPO_MAP.mdDirectory census, deployment modes, major systems
docs/ARCHITECTURE.mdPrinciples, infra choices, layering, conventions
docs/DEPENDENCY_GRAPH.mdFan-in/out, messaging DAG, coupling notes
docs/HOTSPOTS.mdLarge files & structural risks
docs/FLOWS/*.mdEnd-to-end narratives for critical paths

Rule: Prefer these artifacts over improvised mental models. If docs drift from code during your change, patch the relevant markdown.

How to analyze architecture quickly

  1. Identify deployment surface — cmd/server/main.go + deployment.mode. Determine whether edits affect API-only paths, Kafka consumers, or Temporal workers (registerRouterHandlers & startTemporalWorker branches).
  2. Locate the bounded context — map feature → domain package (internal/domain/<ctx>) → repository impl (repository/ent vs repository/clickhouse) → service (internal/ee/service/<file>) → handler (internal/api/v1).
  3. Check async edges — list Kafka topics touched (search config keys under internal/config) and Temporal workflow names (internal/temporal/workflows).
  4. Assess coupling — if you need half of ServiceParams, consider narrowing new code’s dependencies deliberately.

How to reason about dependencies

  • Follow canonical direction: handlers → services → (domain interfaces + repos/integrations) → storage/IO (see diagram in docs/DEPENDENCY_GRAPH.md).
  • Watch logical cycles: Temporal registration reconstructs some services independently of Fx (internal/temporal/registration.go).
  • Question globals: prefer replacing new uses of GetGlobalTemporalService with injected interfaces when editing those call sites safely.

How to persist repository memory

After meaningful structural edits:

Change typeUpdate
New package / major subsystemREPO_MAP.md (+ ARCHITECTURE.md boundaries if philosophical)
New topic/consumer or couplingDEPENDENCY_GRAPH.md + YAML pointer
Emerging risk/god file growthHOTSPOTS.md entry
Flow behavior changeRelevant docs/FLOWS/<name>.md

Treat docs as durable context for future automation and onboarding.

How to refactor safely

  1. Freeze scope — isolate one bounded context or one pipeline stage.
  2. Add or extend characterization tests closest to seams you cut (heavy services deserve targeted tests despite size).
  3. Avoid splitting multi-thousand-line files blindly — extract cohesive types/helpers with stable interfaces (subscription.go, invoice.go, billing.go).
  4. For schema changes — always make generate-ent + deliberate migration rollout; annotate operational risk if backfill jobs required.
  5. For messaging — verify consumer group uniqueness and DLQ configuration when adjusting handler semantics (internal/pubsub/router).

Anti-patterns to flag during review

  • Domain importing repositories or Gin types.
  • Handlers querying Ent directly.
  • Silent topic renames without consumer coordination.
  • New global singletons hiding dependencies.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

apitest

免费

Run local HTTP API checks with a staged workflow: confirm the environment, gather credentials interactively, probe endpoints with curl, and record status codes and response excerpts. For large suites, it can divide independent endpoint groups among workers and merge their results.

中文简介正在准备中。当前显示英语简介。

  • Smoke-checking a local API
  • Testing authenticated endpoints with curl
  • Organizing checks across many endpoints
flexprice/flexprice68762026年10月29日 更新

compose

免费

Use this skill to set up or manage FlexPrice’s local Docker environment. It provides commands to start and stop services, launch Kafka UI, and follow application logs while troubleshooting.

中文简介正在准备中。当前显示英语简介。

  • Setting up the local development environment
  • Starting or stopping FlexPrice services
  • Opening Kafka UI during development
flexprice/flexprice68762026年10月29日 更新

Use this skill to check whether repository AGENTS.md context files have fallen behind code changes. It compares tracked file ownership with Git revisions, prepares focused update bundles for affected layers, and advances sync markers after the context is updated.

中文简介正在准备中。当前显示英语简介。

  • Checking whether AGENTS.md files are stale
  • Refreshing context after code changes
  • Updating one layer’s context file
flexprice/flexprice68762026年10月29日 更新

devenv

免费

Plan a local development setup by mapping which services run in Docker Compose and which use hosted endpoints such as RDS or managed Kafka. The skill guides environment configuration, service checks, migrations, and choosing an application mode.

中文简介正在准备中。当前显示英语简介。

  • Preparing a hybrid local and hosted development setup
  • Starting an API, consumer, or Temporal worker locally
  • Checking environment settings before migrations
flexprice/flexprice68762026年10月29日 更新

gh

免费

Use the GitHub CLI to review pull requests and issues, inspect CI check results and failed logs, and prepare a pull request with a summary and test plan. The skill also outlines the repository review steps before creation.

中文简介正在准备中。当前显示英语简介。

  • Reviewing a pull request or issue from the CLI
  • Finding the cause of a failed CI check
  • Preparing and creating a pull request
flexprice/flexprice68762026年10月29日 更新

godev

免费

Format Go code, check it with go vet, and run focused race tests or the full project test suite. The skill guides a repeatable verification flow after code changes, using Makefile targets when available.

中文简介正在准备中。当前显示英语简介。

  • Checking Go code after a change
  • Running race tests on edited packages
  • Running the full test suite
flexprice/flexprice68762026年10月29日 更新

查看 flexprice 的全部技能

报告此技能的问题