[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M769DFQ9RVP8S9G1ER90CB82":3,"skill-same:01M769DFQ9RVP8S9G1ER90CB82":47},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M769DFQ9RVP8S9G1ER90CB82","queue-rules",null,"MUST NOT \u002F SHOULD NOT rules for background work: queue producers and workers, scheduled jobs, sweeps, reconcilers, backfills, leases, and dedup. Use when writing or reviewing a job, a worker, an enqueue call, or any loop that reads rows on a schedule.","jonathanong\u002Fno-mistakes","jonathanong","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F643505?v=4","01M72BK9Y3KZF7M2AM14BMJBAK","jongleberry","01M72BK9YTVF9K5MW3524R0YJ3",11,"MIT","https:\u002F\u002Fgithub.com\u002Fjonathanong\u002Fno-mistakes\u002Fblob\u002Fmain\u002Fplugins\u002Fno-mistakes-rules\u002Fskills\u002Fqueue-rules\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: queue-rules\ndescription: \"MUST NOT \u002F SHOULD NOT rules for background work: queue producers and workers, scheduled jobs, sweeps, reconcilers, backfills, leases, and dedup. Use when writing or reviewing a job, a worker, an enqueue call, or any loop that reads rows on a schedule.\"\n---\n\n# Queue and background-job rules\n\nMUST NOT is a defect. SHOULD NOT needs a stated, measured reason.\n\n## Producers and workers\n\n- MUST NOT drop the promise of an enqueue or schedule call; `await` it, or mark deliberate fire-and-forget with `void` and a rejection handler.\n- MUST NOT enqueue inside a transaction that may roll back; enqueue after commit. Exception: when the enqueue is the only durable handoff (a consumer whose idempotency row is its only record), enqueue inside the transaction so a failed enqueue rolls the row back; the enqueue must tolerate collisions, and the worker must be idempotent and treat a missing row as a retry.\n- MUST NOT rename a job or change its payload in one step; ship worker support for both shapes, then switch producers, then drop the old once no old-shape jobs remain queued, delayed, or retrying.\n- MUST NOT assume a unique job id prevents duplicate runs; it only dedupes enqueues. Make the work idempotent.\n- MUST NOT key dedup ids by entity alone; include the triggering event, because retained jobs still hold the id.\n- MUST NOT put shared-queue jobs in no ordering lane or with implicit concurrency; one family starves the rest.\n- MUST NOT expect priority to reorder work inside one FIFO lane; give urgent work its own lane.\n- MUST NOT size a global per-key cap as if it were per-process worker concurrency.\n- MUST NOT put high-volume work or dispatchers in the same lane as ordinary tasks.\n- MUST NOT ship a job whose only failure recovery is the dead-letter queue; add a reconciler or document the accepted loss.\n- MUST NOT put secrets or personal data in payloads; pass ids.\n- MUST NOT make producer code import worker code; producers enqueue, workers execute.\n- MUST NOT do slow external work on a request path or in an event-forwarding function; enqueue it.\n- MUST NOT treat a dedup id collision as a failure. If finished or failed jobs keep their ids, check that job's state before treating the work as queued.\n- MUST NOT trust a framework's retry counter without checking that no middleware resets it.\n- MUST NOT expect a code deploy to change concurrency or prefetch settings read at worker start; restart the workers.\n- SHOULD NOT put mutable state in a payload; pass ids and re-read when the job runs. Facts fixed when the event happened, such as the price charged, belong in the payload.\n- SHOULD NOT sleep inside a job; defer it through the queue.\n- SHOULD NOT do the work inside a message consumer; enqueue a job, then ack.\n- SHOULD NOT ship bulk work without sizing it against production volume.\n- SHOULD NOT put business logic in processors; call the service that owns the write.\n- SHOULD NOT add an outbox or lease table by default; use job id = row id, enqueue after commit, and a bounded re-enqueue sweep.\n\n## Leases\n\n- MUST NOT renew, complete, or fail leased work without matching your lease token; zero rows means you lost it.\n- MUST NOT set a lease TTL below the job's lock duration, or release a lease with a plain delete; compare-and-delete by token.\n- MUST NOT hold a lease across a deferral that never returns; release first.\n- MUST NOT let a lease-contention path fall through into the guarded work; defer this job with bounded, jittered delay.\n\n## Sweeps and bounded iteration\n\n- MUST NOT loop until empty or default a cap to infinity; cap rows, batches, or time per run, persist position, report remaining work.\n- MUST NOT treat a cursor or stream as a work bound; it bounds memory only.\n- MUST NOT fan out with unbounded `Promise.all`; bound both the input set and concurrency.\n- MUST NOT scan every entity to find work; read work-item rows through an index-served predicate.\n- MUST NOT restart external listings from page one each run; carry the continuation token and stop on a repeat.\n- MUST NOT let a delayed repair overwrite a newer value; recompute from current source state or compare an existing timestamp instead of adding a version column for it.\n- MUST NOT resume a time window without overlap.\n- MUST NOT hardcode batch size, page size, or window as literals; bind validated config.\n- MUST NOT clear a \"needs work\" flag unconditionally when a run ends; compare-and-clear against the version you read, or a change that arrived mid-run is lost.\n- MUST NOT self-requeue without a no-progress guard.\n- MUST NOT leave a non-terminal state without a timeout exit, or pick work without an `ORDER BY`.\n- SHOULD NOT combine unrelated triggers in one sweep with `OR`; one dispatcher per signal, same idempotent job.\n- SHOULD NOT add a new sweeper for a repair an existing reconciler can make idempotently.\n","# Queue and background-job rules\n\nMUST NOT is a defect. SHOULD NOT needs a stated, measured reason.\n\n## Producers and workers\n\n- MUST NOT drop the promise of an enqueue or schedule call; `await` it, or mark deliberate fire-and-forget with `void` and a rejection handler.\n- MUST NOT enqueue inside a transaction that may roll back; enqueue after commit. Exception: when the enqueue is the only durable handoff (a consumer whose idempotency row is its only record), enqueue inside the transaction so a failed enqueue rolls the row back; the enqueue must tolerate collisions, and the worker must be idempotent and treat a missing row as a retry.\n- MUST NOT rename a job or change its payload in one step; ship worker support for both shapes, then switch producers, then drop the old once no old-shape jobs remain queued, delayed, or retrying.\n- MUST NOT assume a unique job id prevents duplicate runs; it only dedupes enqueues. Make the work idempotent.\n- MUST NOT key dedup ids by entity alone; include the triggering event, because retained jobs still hold the id.\n- MUST NOT put shared-queue jobs in no ordering lane or with implicit concurrency; one family starves the rest.\n- MUST NOT expect priority to reorder work inside one FIFO lane; give urgent work its own lane.\n- MUST NOT size a global per-key cap as if it were per-process worker concurrency.\n- MUST NOT put high-volume work or dispatchers in the same lane as ordinary tasks.\n- MUST NOT ship a job whose only failure recovery is the dead-letter queue; add a reconciler or document the accepted loss.\n- MUST NOT put secrets or personal data in payloads; pass ids.\n- MUST NOT make producer code import worker code; producers enqueue, workers execute.\n- MUST NOT do slow external work on a request path or in an event-forwarding function; enqueue it.\n- MUST NOT treat a dedup id collision as a failure. If finished or failed jobs keep their ids, check that job's state before treating the work as queued.\n- MUST NOT trust a framework's retry counter without checking that no middleware resets it.\n- MUST NOT expect a code deploy to change concurrency or prefetch settings read at worker start; restart the workers.\n- SHOULD NOT put mutable state in a payload; pass ids and re-read when the job runs. Facts fixed when the event happened, such as the price charged, belong in the payload.\n- SHOULD NOT sleep inside a job; defer it through the queue.\n- SHOULD NOT do the work inside a message consumer; enqueue a job, then ack.\n- SHOULD NOT ship bulk work without sizing it against production volume.\n- SHOULD NOT put business logic in processors; call the service that owns the write.\n- SHOULD NOT add an outbox or lease table by default; use job id = row id, enqueue after commit, and a bounded re-enqueue sweep.\n\n## Leases\n\n- MUST NOT renew, complete, or fail leased work without matching your lease token; zero rows means you lost it.\n- MUST NOT set a lease TTL below the job's lock duration, or release a lease with a plain delete; compare-and-delete by token.\n- MUST NOT hold a lease across a deferral that never returns; release first.\n- MUST NOT let a lease-contention path fall through into the guarded work; defer this job with bounded, jittered delay.\n\n## Sweeps and bounded iteration\n\n- MUST NOT loop until empty or default a cap to infinity; cap rows, batches, or time per run, persist position, report remaining work.\n- MUST NOT treat a cursor or stream as a work bound; it bounds memory only.\n- MUST NOT fan out with unbounded `Promise.all`; bound both the input set and concurrency.\n- MUST NOT scan every entity to find work; read work-item rows through an index-served predicate.\n- MUST NOT restart external listings from page one each run; carry the continuation token and stop on a repeat.\n- MUST NOT let a delayed repair overwrite a newer value; recompute from current source state or compare an existing timestamp instead of adding a version column for it.\n- MUST NOT resume a time window without overlap.\n- MUST NOT hardcode batch size, page size, or window as literals; bind validated config.\n- MUST NOT clear a \"needs work\" flag unconditionally when a run ends; compare-and-clear against the version you read, or a change that arrived mid-run is lost.\n- MUST NOT self-requeue without a no-progress guard.\n- MUST NOT leave a non-terminal state without a timeout exit, or pick work without an `ORDER BY`.\n- SHOULD NOT combine unrelated triggers in one sweep with `OR`; one dispatcher per signal, same idempotent job.\n- SHOULD NOT add a new sweeper for a repair an existing reconciler can make idempotently.\n",{"name":5,"description":7},"main","e5047e47e5124552e6426c71c7040e959038c6b9","plugins\u002Fno-mistakes-rules\u002Fskills\u002Fqueue-rules",1,"https:\u002F\u002Fgithub.com\u002Fjonathanong\u002Fno-mistakes","https:\u002F\u002Fgithub.com\u002Fjonathanong","https:\u002F\u002Fjongleberry.com","@expressjs @koajs @jshttp @pillarjs ","2026-11-15 04:43:39",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add jonathanong\u002Fno-mistakes --skill queue-rules",{"tool":39,"command":40},"bunx","bunx skills add jonathanong\u002Fno-mistakes --skill queue-rules",{"tool":42,"command":43},"pnpm","pnpm dlx skills add jonathanong\u002Fno-mistakes --skill queue-rules","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjonathanong\u002Fno-mistakes\u002Fblob\u002Fmain\u002Fplugins\u002Fno-mistakes-rules\u002Fskills\u002Fqueue-rules\u002FSKILL.md",true,[],[48,56,63,70,77,84],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":55},"01M78R0B1G0N7C5MK135GKWF5M","rollout-rules","MUST NOT \u002F SHOULD NOT rules for shipping changes safely: feature flags, deploy order across services, API and message compatibility, irreversible actions, and string-referenced config. Use when adding a flag, changing an API or message contract, deploying a change that spans services, or touching money-moving or irreversible actions.","https:\u002F\u002Fgithub.com\u002Fjonathanong\u002Fno-mistakes\u002Fblob\u002Fmain\u002Fplugins\u002Fno-mistakes-rules\u002Fskills\u002Frollout-rules\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":55},"01M78R01TNND6HJYM8YHWTAM2P","observability-rules","MUST NOT \u002F SHOULD NOT rules for logs, metrics, and alerts: static messages and structured fields, personal data, metric cardinality, fields monitors depend on, absence alerts, and context binding. Use when adding or reviewing logging, metrics, or monitors.","https:\u002F\u002Fgithub.com\u002Fjonathanong\u002Fno-mistakes\u002Fblob\u002Fmain\u002Fplugins\u002Fno-mistakes-rules\u002Fskills\u002Fobservability-rules\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":55},"01M78QZZ9X353064KF1V7CX47X","integrations-rules","MUST NOT \u002F SHOULD NOT rules for third-party APIs and inbound webhooks: response classification, retries and idempotency, delivery records, payload mapping, timestamps and units, batch failure policy, and signature verification. Use when calling, parsing, or receiving a partner or vendor API.","https:\u002F\u002Fgithub.com\u002Fjonathanong\u002Fno-mistakes\u002Fblob\u002Fmain\u002Fplugins\u002Fno-mistakes-rules\u002Fskills\u002Fintegrations-rules\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M769DZRM1XK1A806Q5STPJ7P","typescript-rules","MUST NOT \u002F SHOULD NOT rules for TypeScript, JavaScript, and Node.js: async and promises, errors, mutation, aliases and dead paths, static analysis, process lifecycle, HTTP clients, caches like Redis or Valkey, and package boundaries. Use when writing or reviewing TS\u002FJS or Node code.","https:\u002F\u002Fgithub.com\u002Fjonathanong\u002Fno-mistakes\u002Fblob\u002Fmain\u002Fplugins\u002Fno-mistakes-rules\u002Fskills\u002Ftypescript-rules\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M769DSBAADFTZZ8JDWSBBT3Y","security-rules","MUST NOT \u002F SHOULD NOT rules for application security and HTTP APIs: secrets, auth and sessions, SSRF, injection, CSRF, CSP, LLM prompts, response exposure, and API shape. Use when writing or reviewing an endpoint, auth code, secret handling, outbound fetches, or LLM calls.","https:\u002F\u002Fgithub.com\u002Fjonathanong\u002Fno-mistakes\u002Fblob\u002Fmain\u002Fplugins\u002Fno-mistakes-rules\u002Fskills\u002Fsecurity-rules\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M769DP8CJDMVP8S50994GM4P","rust-rules","MUST NOT \u002F SHOULD NOT rules for Rust: lints, test layout, file size, parallelism, hot loops, caching, build hygiene, and performance claims. Use when writing or reviewing Rust code or running heavy cargo builds.","https:\u002F\u002Fgithub.com\u002Fjonathanong\u002Fno-mistakes\u002Fblob\u002Fmain\u002Fplugins\u002Fno-mistakes-rules\u002Fskills\u002Frust-rules\u002FSKILL.md",[],[]]