[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79GR4P3HPKT6EATC7KCVEEV":3,"skill-same:01M79GR4P3HPKT6EATC7KCVEEV":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},"01M79GR4P3HPKT6EATC7KCVEEV","scaffold-decorator",null,"Add or wire helpers\u002Fdecorators, preferring ArchiPy's (ttl_cache, atomic UoW, trace_span, measure_duration, retry). Use for \"cache this function\", \"add timing\u002Ftracing\u002Fretry\", or \"write a decorator\".","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-decorator\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: scaffold-decorator\ndescription: >-\n  Add or wire helpers\u002Fdecorators, preferring ArchiPy's (ttl_cache, atomic UoW,\n  trace_span, measure_duration, retry). Use for \"cache this function\", \"add\n  timing\u002Ftracing\u002Fretry\", or \"write a decorator\".\n---\n\n# Scaffold ArchiPy Decorator\n\n## Scope\n\n**Only** `helpers\u002Fdecorators\u002F`. Do not create utils or interceptors 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-decorators.mdc`\n\n## Before writing files\n\n1. Inspect existing decorators, call sites, and the installed ArchiPy version for a matching decorator.\n2. Infer sync\u002Fasync style and project naming from the target call site.\n3. Ask only for unresolved behavior. Prefer an ArchiPy decorator whenever it fits.\n4. Preserve existing decorator modules; do not overwrite.\n\n## Prefer ArchiPy\n\nExamples:\n\n- `from archipy.helpers.decorators import ttl_cache`\n- `from archipy.adapters.base.sqlalchemy.atomic import postgres_sqlalchemy_atomic` (detects `async def`)\n- `trace_span` \u002F `trace_root` (+ async twins) from `archipy.helpers.decorators.tracing`\n- `measure_duration` \u002F `count_calls` (+ async twins) from `archipy.helpers.decorators.metrics`\n- `timeout`, `retry`, `singleton`, `timing`, and\n  `grpc_rate_limit` under `archipy.helpers.decorators`\n\nShow correct usage on a sample function; do not reimplement. UoW decorators belong on **logics**, not\nservices\u002Frepositories.\n\n## Custom decorator\n\nCreate `helpers\u002Fdecorators\u002F\u003Cname>.py`:\n\n```python\nfrom __future__ import annotations\n\nimport functools\nimport inspect\nimport logging\nimport time\nfrom collections.abc import Callable\nfrom typing import ParamSpec, TypeVar\n\nlogger = logging.getLogger(__name__)\n\nP = ParamSpec(\"P\")\nR = TypeVar(\"R\")\n\n\ndef timed(func: Callable[P, R]) -> Callable[P, R]:\n    \"\"\"Log wall-clock duration of a sync call.\n\n    Args:\n        func: Callable to wrap.\n\n    Returns:\n        Wrapped callable that logs elapsed milliseconds.\n\n    Raises:\n        TypeError: If `func` is a coroutine function — use an async twin instead.\n\n    Example:\n        @timed\n        def build_report(order_id: str) -> str:\n            ...\n    \"\"\"\n    if inspect.iscoroutinefunction(func):\n        raise TypeError(f\"{func.__qualname__} is async; use an async twin instead of timed()\")\n\n    @functools.wraps(func)\n    def wrapper(*args: P.args, **kwargs: P.kwargs) -> R:\n        started = time.perf_counter()\n        try:\n            return func(*args, **kwargs)\n        finally:\n            elapsed_ms = (time.perf_counter() - started) * 1000\n            logger.debug(\"%s took %.2f ms\", func.__qualname__, elapsed_ms)\n\n    return wrapper\n```\n\n- Use `functools.wraps`\n- Preserve types where practical (`ParamSpec` \u002F `TypeVar`)\n- Google-style docstring with Args\u002FReturns and a usage example\n- **No** concrete adapter imports at module level\n- One decorator detects `async def` with `inspect.iscoroutinefunction` and returns a sync or async wrapper\n\n## Do not\n\n- Wrap an `async def` with a sync wrapper (it would return an un-awaited coroutine).\n\n## Verify\n\nRun formatter\u002Flinter and focused tests for return values, exceptions, and metadata\u002Fsignature preservation. Report the\nreused ArchiPy API or files created, plus commands run.\n\n## Docs\n\n- https:\u002F\u002Fsyntaxarc.github.io\u002FArchiPy\u002Ftutorials\u002Fhelpers\u002F\n- Bundled skill reference: `..\u002Farchipy-docs\u002Freference\u002Fhelpers.md` (Decorators section), resolved relative to this `SKILL.md`'s\n  directory in the plugin installation — not the app workspace.\n","# Scaffold ArchiPy Decorator\n\n## Scope\n\n**Only** `helpers\u002Fdecorators\u002F`. Do not create utils or interceptors 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-decorators.mdc`\n\n## Before writing files\n\n1. Inspect existing decorators, call sites, and the installed ArchiPy version for a matching decorator.\n2. Infer sync\u002Fasync style and project naming from the target call site.\n3. Ask only for unresolved behavior. Prefer an ArchiPy decorator whenever it fits.\n4. Preserve existing decorator modules; do not overwrite.\n\n## Prefer ArchiPy\n\nExamples:\n\n- `from archipy.helpers.decorators import ttl_cache`\n- `from archipy.adapters.base.sqlalchemy.atomic import postgres_sqlalchemy_atomic` (detects `async def`)\n- `trace_span` \u002F `trace_root` (+ async twins) from `archipy.helpers.decorators.tracing`\n- `measure_duration` \u002F `count_calls` (+ async twins) from `archipy.helpers.decorators.metrics`\n- `timeout`, `retry`, `singleton`, `timing`, and\n  `grpc_rate_limit` under `archipy.helpers.decorators`\n\nShow correct usage on a sample function; do not reimplement. UoW decorators belong on **logics**, not\nservices\u002Frepositories.\n\n## Custom decorator\n\nCreate `helpers\u002Fdecorators\u002F\u003Cname>.py`:\n\n```python\nfrom __future__ import annotations\n\nimport functools\nimport inspect\nimport logging\nimport time\nfrom collections.abc import Callable\nfrom typing import ParamSpec, TypeVar\n\nlogger = logging.getLogger(__name__)\n\nP = ParamSpec(\"P\")\nR = TypeVar(\"R\")\n\n\ndef timed(func: Callable[P, R]) -> Callable[P, R]:\n    \"\"\"Log wall-clock duration of a sync call.\n\n    Args:\n        func: Callable to wrap.\n\n    Returns:\n        Wrapped callable that logs elapsed milliseconds.\n\n    Raises:\n        TypeError: If `func` is a coroutine function — use an async twin instead.\n\n    Example:\n        @timed\n        def build_report(order_id: str) -> str:\n            ...\n    \"\"\"\n    if inspect.iscoroutinefunction(func):\n        raise TypeError(f\"{func.__qualname__} is async; use an async twin instead of timed()\")\n\n    @functools.wraps(func)\n    def wrapper(*args: P.args, **kwargs: P.kwargs) -> R:\n        started = time.perf_counter()\n        try:\n            return func(*args, **kwargs)\n        finally:\n            elapsed_ms = (time.perf_counter() - started) * 1000\n            logger.debug(\"%s took %.2f ms\", func.__qualname__, elapsed_ms)\n\n    return wrapper\n```\n\n- Use `functools.wraps`\n- Preserve types where practical (`ParamSpec` \u002F `TypeVar`)\n- Google-style docstring with Args\u002FReturns and a usage example\n- **No** concrete adapter imports at module level\n- One decorator detects `async def` with `inspect.iscoroutinefunction` and returns a sync or async wrapper\n\n## Do not\n\n- Wrap an `async def` with a sync wrapper (it would return an un-awaited coroutine).\n\n## Verify\n\nRun formatter\u002Flinter and focused tests for return values, exceptions, and metadata\u002Fsignature preservation. Report the\nreused ArchiPy API or files created, plus commands run.\n\n## Docs\n\n- https:\u002F\u002Fsyntaxarc.github.io\u002FArchiPy\u002Ftutorials\u002Fhelpers\u002F\n- Bundled skill reference: `..\u002Farchipy-docs\u002Freference\u002Fhelpers.md` (Decorators section), resolved relative to this `SKILL.md`'s\n  directory in the plugin installation — not the app workspace.\n",{"name":5,"description":7},"main","60b791bf9902a80e9a0bbac9d7cf04ea5c559af0","skills\u002Fscaffold-decorator",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-decorator",{"tool":38,"command":39},"bunx","bunx skills add SyntaxArc\u002Farchipy-plugin --skill scaffold-decorator",{"tool":41,"command":42},"pnpm","pnpm dlx skills add SyntaxArc\u002Farchipy-plugin --skill scaffold-decorator","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSyntaxArc\u002Farchipy-plugin\u002Fblob\u002Fmain\u002Fskills\u002Fscaffold-decorator\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},"01M79GRF6HFDN1RZMPZJM54TGR","scaffold-interceptor","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\".","https:\u002F\u002Fgithub.com\u002FSyntaxArc\u002Farchipy-plugin\u002Fblob\u002Fmain\u002Fskills\u002Fscaffold-interceptor\u002FSKILL.md",[],[]]