[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79GRF6HFDN1RZMPZJM54TGR":3,"skill-same:01M79GRF6HFDN1RZMPZJM54TGR":46},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M79GRF6HFDN1RZMPZJM54TGR","scaffold-interceptor",null,"Add or wire cross-cutting FastAPI\u002FgRPC interceptors or middleware, preferring ArchiPy's. Use for \"add middleware\", \"request ID\u002Flogging\u002Fauth interceptor\", or \"gRPC interceptor\".","SyntaxArc\u002Farchipy-plugin","SyntaxArc","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F199446442?v=4","01M79GPX74Y0R3C1MTXHETZZYF","01M79GPX7S33ZRJ5935EQ3JRPN",3,"MIT","https:\u002F\u002Fgithub.com\u002FSyntaxArc\u002Farchipy-plugin\u002Fblob\u002Fmain\u002Fskills\u002Fscaffold-interceptor\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: scaffold-interceptor\ndescription: >-\n  Add or wire cross-cutting FastAPI\u002FgRPC interceptors or middleware, preferring\n  ArchiPy's. Use for \"add middleware\", \"request ID\u002Flogging\u002Fauth interceptor\", or \"gRPC\n  interceptor\".\n---\n\n# Scaffold ArchiPy Interceptor\n\n## Scope\n\n**Only** `helpers\u002Finterceptors\u002F`. Do not create utils or decorators here.\n\n## Read first\n\nRead these plugin rules in full before generating files (paths relative to this skill directory; Claude Code: `${CLAUDE_SKILL_DIR}\u002F..\u002F..\u002Frules\u002F`):\n\n- `..\u002F..\u002Frules\u002Fusing-archipy-interceptors.mdc`\n\n## Before writing files\n\n1. Inspect app bootstrap, existing interceptors\u002Fmiddleware, DI wiring, and the installed ArchiPy version.\n2. Infer framework and sync\u002Fasync style from the repository.\n3. Ask only for an unresolved cross-cutting concern or framework choice. Prefer an ArchiPy interceptor whenever it\n   fits.\n4. Preserve existing registration order and modules; do not overwrite.\n\n## Prefer ArchiPy\n\nCheck `archipy.helpers.interceptors` (FastAPI \u002F gRPC). Prefer AppUtils auto-registration for stock interceptors. Show\nregistration via DI or framework APIs from docs \u002F `..\u002Farchipy-docs\u002Freference\u002Fhelpers.md` (Interceptors), resolved relative to\nthis `SKILL.md`'s directory in the plugin installation — not the app workspace.\n\n## Custom interceptor\n\nCreate under `helpers\u002Finterceptors\u002F` — FastAPI middleware sketch:\n\n```python\nfrom __future__ import annotations\n\nimport logging\nimport time\nimport uuid\nfrom collections.abc import Awaitable, Callable\n\nfrom starlette.middleware.base import BaseHTTPMiddleware\nfrom starlette.requests import Request\nfrom starlette.responses import Response\n\nlogger = logging.getLogger(__name__)\n\n\nclass RequestIdMiddleware(BaseHTTPMiddleware):\n    \"\"\"Attach\u002Fpropagate an X-Request-ID header — cross-cutting only.\"\"\"\n\n    async def dispatch(\n        self,\n        request: Request,\n        call_next: Callable[[Request], Awaitable[Response]],\n    ) -> Response:\n        request_id = request.headers.get(\"x-request-id\") or str(uuid.uuid4())\n        started = time.perf_counter()\n        response = await call_next(request)\n        response.headers[\"X-Request-ID\"] = request_id\n        logger.debug(\n            \"request_id=%s method=%s path=%s status=%s duration_ms=%.2f\",\n            request_id,\n            request.method,\n            request.url.path,\n            response.status_code,\n            (time.perf_counter() - started) * 1000,\n        )\n        return response\n```\n\n- No domain business writes\n- No adapter construction inside the interceptor module\n- Wire through `configs\u002Fcontainers.py`, `AppUtils`, or framework middleware registration\n- Map errors at the boundary; do not leak raw exceptions\n\n## Do not\n\n- Keep cross-cutting only — no domain use-case logic, no domain business writes.\n- Do not create utils or decorators in this step.\n\n## Verify\n\nRun formatter\u002Flinter and Behave scenarios through the `AppUtils`-built app (`\u002Fscaffold-bdd` harness) for ordering,\nsuccess, and mapped failure behavior. Confirm registration\noccurs once. Report the reused ArchiPy API or files created, plus commands run.\n\n## Docs\n\n- https:\u002F\u002Fsyntaxarc.github.io\u002FArchiPy\u002Ftutorials\u002Fhelpers\u002F\n- https:\u002F\u002Fsyntaxarc.github.io\u002FArchiPy\u002Ftutorials\u002Fobservability\u002F\n- Bundled skill reference: `..\u002Farchipy-docs\u002Freference\u002Fhelpers.md` (Interceptors section)\n","# Scaffold ArchiPy Interceptor\n\n## Scope\n\n**Only** `helpers\u002Finterceptors\u002F`. Do not create utils or decorators here.\n\n## Read first\n\nRead these plugin rules in full before generating files (paths relative to this skill directory; Claude Code: `${CLAUDE_SKILL_DIR}\u002F..\u002F..\u002Frules\u002F`):\n\n- `..\u002F..\u002Frules\u002Fusing-archipy-interceptors.mdc`\n\n## Before writing files\n\n1. Inspect app bootstrap, existing interceptors\u002Fmiddleware, DI wiring, and the installed ArchiPy version.\n2. Infer framework and sync\u002Fasync style from the repository.\n3. Ask only for an unresolved cross-cutting concern or framework choice. Prefer an ArchiPy interceptor whenever it\n   fits.\n4. Preserve existing registration order and modules; do not overwrite.\n\n## Prefer ArchiPy\n\nCheck `archipy.helpers.interceptors` (FastAPI \u002F gRPC). Prefer AppUtils auto-registration for stock interceptors. Show\nregistration via DI or framework APIs from docs \u002F `..\u002Farchipy-docs\u002Freference\u002Fhelpers.md` (Interceptors), resolved relative to\nthis `SKILL.md`'s directory in the plugin installation — not the app workspace.\n\n## Custom interceptor\n\nCreate under `helpers\u002Finterceptors\u002F` — FastAPI middleware sketch:\n\n```python\nfrom __future__ import annotations\n\nimport logging\nimport time\nimport uuid\nfrom collections.abc import Awaitable, Callable\n\nfrom starlette.middleware.base import BaseHTTPMiddleware\nfrom starlette.requests import Request\nfrom starlette.responses import Response\n\nlogger = logging.getLogger(__name__)\n\n\nclass RequestIdMiddleware(BaseHTTPMiddleware):\n    \"\"\"Attach\u002Fpropagate an X-Request-ID header — cross-cutting only.\"\"\"\n\n    async def dispatch(\n        self,\n        request: Request,\n        call_next: Callable[[Request], Awaitable[Response]],\n    ) -> Response:\n        request_id = request.headers.get(\"x-request-id\") or str(uuid.uuid4())\n        started = time.perf_counter()\n        response = await call_next(request)\n        response.headers[\"X-Request-ID\"] = request_id\n        logger.debug(\n            \"request_id=%s method=%s path=%s status=%s duration_ms=%.2f\",\n            request_id,\n            request.method,\n            request.url.path,\n            response.status_code,\n            (time.perf_counter() - started) * 1000,\n        )\n        return response\n```\n\n- No domain business writes\n- No adapter construction inside the interceptor module\n- Wire through `configs\u002Fcontainers.py`, `AppUtils`, or framework middleware registration\n- Map errors at the boundary; do not leak raw exceptions\n\n## Do not\n\n- Keep cross-cutting only — no domain use-case logic, no domain business writes.\n- Do not create utils or decorators in this step.\n\n## Verify\n\nRun formatter\u002Flinter and Behave scenarios through the `AppUtils`-built app (`\u002Fscaffold-bdd` harness) for ordering,\nsuccess, and mapped failure behavior. Confirm registration\noccurs once. Report the reused ArchiPy API or files created, plus commands run.\n\n## Docs\n\n- https:\u002F\u002Fsyntaxarc.github.io\u002FArchiPy\u002Ftutorials\u002Fhelpers\u002F\n- https:\u002F\u002Fsyntaxarc.github.io\u002FArchiPy\u002Ftutorials\u002Fobservability\u002F\n- Bundled skill reference: `..\u002Farchipy-docs\u002Freference\u002Fhelpers.md` (Interceptors section)\n",{"name":5,"description":7},"main","60b791bf9902a80e9a0bbac9d7cf04ea5c559af0","skills\u002Fscaffold-interceptor",1,"https:\u002F\u002Fgithub.com\u002FSyntaxArc\u002Farchipy-plugin","https:\u002F\u002Fsyntaxarc.github.io\u002FArchiPy\u002F","https:\u002F\u002Fgithub.com\u002FSyntaxArc","A structured, modern approach to development.","2026-11-07 21:30:40",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add SyntaxArc\u002Farchipy-plugin --skill scaffold-interceptor",{"tool":38,"command":39},"bunx","bunx skills add SyntaxArc\u002Farchipy-plugin --skill scaffold-interceptor",{"tool":41,"command":42},"pnpm","pnpm dlx skills add SyntaxArc\u002Farchipy-plugin --skill scaffold-interceptor","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSyntaxArc\u002Farchipy-plugin\u002Fblob\u002Fmain\u002Fskills\u002Fscaffold-interceptor\u002FSKILL.md",true,[],[47,54,61,68,75,82],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":18},"01M79GRZRMZGQ4N8DZY0JQ1TYC","scaffold-utils","Add or wire pure helpers\u002Futils, preferring ArchiPy utils (datetime, JWT, password, file, string). Use for \"add a helper\u002Futil function\", \"format dates\", \"hash passwords\", or \"generate tokens\".","https:\u002F\u002Fgithub.com\u002FSyntaxArc\u002Farchipy-plugin\u002Fblob\u002Fmain\u002Fskills\u002Fscaffold-utils\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":18},"01M79GRWMT4CC0MEQNWPJF3MA3","scaffold-service","Scaffold a thin FastAPI router or gRPC servicer under services\u002F{domain}\u002Fv{n}\u002F with AppUtils bootstrap. Use for \"add an endpoint\u002Froute\u002FAPI\", \"expose via REST\u002FgRPC\", or \"new API version\".","https:\u002F\u002Fgithub.com\u002FSyntaxArc\u002Farchipy-plugin\u002Fblob\u002Fmain\u002Fskills\u002Fscaffold-service\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M79GRSR9RZBGFSHY8F0G4Z95","scaffold-observability","Configure ArchiPy 5.x OpenTelemetry traces, metrics, logs, and instrumentation. Use for \"add tracing\u002Fmetrics\u002FOTel\", \"Prometheus\u002FPushgateway\", or migrating off Sentry, Elastic APM, or old Prometheus.","https:\u002F\u002Fgithub.com\u002FSyntaxArc\u002Farchipy-plugin\u002Fblob\u002Fmain\u002Fskills\u002Fscaffold-observability\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":18},"01M79GRPK6B0S157614VXJCW5Y","scaffold-models","Scaffold ArchiPy models under models\u002F: domain\u002Frepository DTOs, errors, optional entities and types. Use for \"add DTO\u002Fschema\u002Frequest\u002Fresponse model\", \"new error type\", or \"SQLAlchemy entity\".","https:\u002F\u002Fgithub.com\u002FSyntaxArc\u002Farchipy-plugin\u002Fblob\u002Fmain\u002Fskills\u002Fscaffold-models\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":18},"01M79GRK8F6RZPX6V4EA24379G","scaffold-logic","Scaffold an ArchiPy logic (use case) under logics\u002F{domain}\u002F with a unit-of-work decorator and DTO I\u002FO. Use for \"add business logic\", \"new use case\", \"transactional operation\", or \"service layer method\".","https:\u002F\u002Fgithub.com\u002FSyntaxArc\u002Farchipy-plugin\u002Fblob\u002Fmain\u002Fskills\u002Fscaffold-logic\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":18},"01M79GRAZBDYDTX9JMBX171KEK","scaffold-health-checks","Scaffold FastAPI\u002FgRPC liveness, readiness, and startup health checks, graceful shutdown, and optional Kubernetes probes. Use for \"health endpoint\", \"readiness\u002Fliveness probe\", or \"k8s probes\".","https:\u002F\u002Fgithub.com\u002FSyntaxArc\u002Farchipy-plugin\u002Fblob\u002Fmain\u002Fskills\u002Fscaffold-health-checks\u002FSKILL.md",[],[]]