[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CBZK3RZ0HFFMX4S0HXEDPC":3,"skill-same:01M7CBZK3RZ0HFFMX4S0HXEDPC":52},{"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":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M7CBZK3RZ0HFFMX4S0HXEDPC","condition-based-waiting",null,"Use when tests have race conditions, timing dependencies, or inconsistent pass\u002Ffail behavior - replaces arbitrary timeouts with condition polling to wait for actual state changes, eliminating flaky tests from timing guesses","shenyimings\u002Fskillet","shenyimings","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F89332218?v=4","01M7C9KHMXPPXMQJCKN78FKB06","Yiming Shen","01M7C9KHP4KS809T2A9T64YDWE",0,"MIT","https:\u002F\u002Fgithub.com\u002Fshenyimings\u002Fskillet\u002Fblob\u002Fmain\u002Fbenchmark\u002Fwild\u002Fdev\u002Fsuspicious\u002Falexsandrocruz__ZenPowers__skills__condition-based-waiting\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: condition-based-waiting\ndescription: Use when tests have race conditions, timing dependencies, or inconsistent pass\u002Ffail behavior - replaces arbitrary timeouts with condition polling to wait for actual state changes, eliminating flaky tests from timing guesses\n---\n\n# Condition-Based Waiting\n\n## Overview\n\nFlaky tests often guess at timing with arbitrary delays. This creates race conditions where tests pass on fast machines but fail under load or in CI.\n\n**Core principle:** Wait for the actual condition you care about, not a guess about how long it takes.\n\n## When to Use\n\n```dot\ndigraph when_to_use {\n    \"Test uses setTimeout\u002Fsleep?\" [shape=diamond];\n    \"Testing timing behavior?\" [shape=diamond];\n    \"Document WHY timeout needed\" [shape=box];\n    \"Use condition-based waiting\" [shape=box];\n\n    \"Test uses setTimeout\u002Fsleep?\" -> \"Testing timing behavior?\" [label=\"yes\"];\n    \"Testing timing behavior?\" -> \"Document WHY timeout needed\" [label=\"yes\"];\n    \"Testing timing behavior?\" -> \"Use condition-based waiting\" [label=\"no\"];\n}\n```\n\n**Use when:**\n- Tests have arbitrary delays (`setTimeout`, `sleep`, `time.sleep()`)\n- Tests are flaky (pass sometimes, fail under load)\n- Tests timeout when run in parallel\n- Waiting for async operations to complete\n\n**Don't use when:**\n- Testing actual timing behavior (debounce, throttle intervals)\n- Always document WHY if using arbitrary timeout\n\n## Core Pattern\n\n```csharp\n\u002F\u002F ❌ BEFORE: Guessing at timing\nawait Task.Delay(50);\nvar result = GetResult();\nAssert.NotNull(result);\n\n\u002F\u002F ✅ AFTER: Waiting for condition\nawait WaitForAsync(() => GetResult() != null);\nvar result = GetResult();\nAssert.NotNull(result);\n```\n\n## Quick Patterns\n\n| Scenario | Pattern |\n|----------|---------|\n| Wait for event | `await WaitForAsync(() => events.Any(e => e.Type == EventType.Done))` |\n| Wait for state | `await WaitForAsync(() => machine.State == MachineState.Ready)` |\n| Wait for count | `await WaitForAsync(() => items.Count >= 5)` |\n| Wait for file | `await WaitForAsync(() => File.Exists(path))` |\n| Complex condition | `await WaitForAsync(() => obj.IsReady && obj.Value > 10)` |\n\n## Implementation\n\nGeneric polling function:\n```csharp\npublic static async Task\u003CT> WaitForAsync\u003CT>(\n    Func\u003CT?> condition,\n    string description,\n    int timeoutMs = 5000,\n    int pollIntervalMs = 10,\n    CancellationToken cancellationToken = default)\n    where T : class\n{\n    var startTime = DateTime.UtcNow;\n    \n    while (!cancellationToken.IsCancellationRequested)\n    {\n        var result = condition();\n        if (result != null) return result;\n        \n        if ((DateTime.UtcNow - startTime).TotalMilliseconds > timeoutMs)\n        {\n            throw new TimeoutException($\"Timeout waiting for {description} after {timeoutMs}ms\");\n        }\n        \n        await Task.Delay(pollIntervalMs, cancellationToken);\n    }\n    \n    throw new OperationCanceledException();\n}\n\n\u002F\u002F Overload for boolean conditions\npublic static async Task WaitForAsync(\n    Func\u003Cbool> condition,\n    string description,\n    int timeoutMs = 5000,\n    int pollIntervalMs = 10,\n    CancellationToken cancellationToken = default)\n{\n    await WaitForAsync(() => condition() ? true : null, description, timeoutMs, pollIntervalMs, cancellationToken);\n}\n```\n\nSee @example.cs for complete implementation with domain-specific helpers (`WaitForEventAsync`, `WaitForEventCountAsync`, `WaitForEventMatchAsync`) from actual debugging session.\n\n## Common Mistakes\n\n**❌ Polling too fast:** `Task.Delay(1)` - wastes CPU\n**✅ Fix:** Poll every 10ms\n\n**❌ No timeout:** Loop forever if condition never met\n**✅ Fix:** Always include timeout with clear error\n\n**❌ Stale data:** Cache state before loop\n**✅ Fix:** Call getter inside loop for fresh data\n\n## When Arbitrary Timeout IS Correct\n\n```csharp\n\u002F\u002F Tool ticks every 100ms - need 2 ticks to verify partial output\nawait WaitForEventAsync(manager, ToolEventType.Started); \u002F\u002F First: wait for condition\nawait Task.Delay(200);   \u002F\u002F Then: wait for timed behavior\n\u002F\u002F 200ms = 2 ticks at 100ms intervals - documented and justified\n```\n\n**Requirements:**\n1. First wait for triggering condition\n2. Based on known timing (not guessing)\n3. Comment explaining WHY\n\n## Real-World Impact\n\nFrom debugging session (2025-10-03):\n- Fixed 15 flaky tests across 3 files\n- Pass rate: 60% → 100%\n- Execution time: 40% faster\n- No more race conditions\n","# Condition-Based Waiting\n\n## Overview\n\nFlaky tests often guess at timing with arbitrary delays. This creates race conditions where tests pass on fast machines but fail under load or in CI.\n\n**Core principle:** Wait for the actual condition you care about, not a guess about how long it takes.\n\n## When to Use\n\n```dot\ndigraph when_to_use {\n    \"Test uses setTimeout\u002Fsleep?\" [shape=diamond];\n    \"Testing timing behavior?\" [shape=diamond];\n    \"Document WHY timeout needed\" [shape=box];\n    \"Use condition-based waiting\" [shape=box];\n\n    \"Test uses setTimeout\u002Fsleep?\" -> \"Testing timing behavior?\" [label=\"yes\"];\n    \"Testing timing behavior?\" -> \"Document WHY timeout needed\" [label=\"yes\"];\n    \"Testing timing behavior?\" -> \"Use condition-based waiting\" [label=\"no\"];\n}\n```\n\n**Use when:**\n- Tests have arbitrary delays (`setTimeout`, `sleep`, `time.sleep()`)\n- Tests are flaky (pass sometimes, fail under load)\n- Tests timeout when run in parallel\n- Waiting for async operations to complete\n\n**Don't use when:**\n- Testing actual timing behavior (debounce, throttle intervals)\n- Always document WHY if using arbitrary timeout\n\n## Core Pattern\n\n```csharp\n\u002F\u002F ❌ BEFORE: Guessing at timing\nawait Task.Delay(50);\nvar result = GetResult();\nAssert.NotNull(result);\n\n\u002F\u002F ✅ AFTER: Waiting for condition\nawait WaitForAsync(() => GetResult() != null);\nvar result = GetResult();\nAssert.NotNull(result);\n```\n\n## Quick Patterns\n\n| Scenario | Pattern |\n|----------|---------|\n| Wait for event | `await WaitForAsync(() => events.Any(e => e.Type == EventType.Done))` |\n| Wait for state | `await WaitForAsync(() => machine.State == MachineState.Ready)` |\n| Wait for count | `await WaitForAsync(() => items.Count >= 5)` |\n| Wait for file | `await WaitForAsync(() => File.Exists(path))` |\n| Complex condition | `await WaitForAsync(() => obj.IsReady && obj.Value > 10)` |\n\n## Implementation\n\nGeneric polling function:\n```csharp\npublic static async Task\u003CT> WaitForAsync\u003CT>(\n    Func\u003CT?> condition,\n    string description,\n    int timeoutMs = 5000,\n    int pollIntervalMs = 10,\n    CancellationToken cancellationToken = default)\n    where T : class\n{\n    var startTime = DateTime.UtcNow;\n    \n    while (!cancellationToken.IsCancellationRequested)\n    {\n        var result = condition();\n        if (result != null) return result;\n        \n        if ((DateTime.UtcNow - startTime).TotalMilliseconds > timeoutMs)\n        {\n            throw new TimeoutException($\"Timeout waiting for {description} after {timeoutMs}ms\");\n        }\n        \n        await Task.Delay(pollIntervalMs, cancellationToken);\n    }\n    \n    throw new OperationCanceledException();\n}\n\n\u002F\u002F Overload for boolean conditions\npublic static async Task WaitForAsync(\n    Func\u003Cbool> condition,\n    string description,\n    int timeoutMs = 5000,\n    int pollIntervalMs = 10,\n    CancellationToken cancellationToken = default)\n{\n    await WaitForAsync(() => condition() ? true : null, description, timeoutMs, pollIntervalMs, cancellationToken);\n}\n```\n\nSee @example.cs for complete implementation with domain-specific helpers (`WaitForEventAsync`, `WaitForEventCountAsync`, `WaitForEventMatchAsync`) from actual debugging session.\n\n## Common Mistakes\n\n**❌ Polling too fast:** `Task.Delay(1)` - wastes CPU\n**✅ Fix:** Poll every 10ms\n\n**❌ No timeout:** Loop forever if condition never met\n**✅ Fix:** Always include timeout with clear error\n\n**❌ Stale data:** Cache state before loop\n**✅ Fix:** Call getter inside loop for fresh data\n\n## When Arbitrary Timeout IS Correct\n\n```csharp\n\u002F\u002F Tool ticks every 100ms - need 2 ticks to verify partial output\nawait WaitForEventAsync(manager, ToolEventType.Started); \u002F\u002F First: wait for condition\nawait Task.Delay(200);   \u002F\u002F Then: wait for timed behavior\n\u002F\u002F 200ms = 2 ticks at 100ms intervals - documented and justified\n```\n\n**Requirements:**\n1. First wait for triggering condition\n2. Based on known timing (not guessing)\n3. Comment explaining WHY\n\n## Real-World Impact\n\nFrom debugging session (2025-10-03):\n- Fixed 15 flaky tests across 3 files\n- Pass rate: 60% → 100%\n- Execution time: 40% faster\n- No more race conditions\n",{"name":5,"description":7},"main","9eadad1eb0fcedc7b086d57b24f1f18310ac285a","benchmark\u002Fwild\u002Fdev\u002Fsuspicious\u002Falexsandrocruz__ZenPowers__skills__condition-based-waiting","https:\u002F\u002Fgithub.com\u002Fshenyimings\u002Fskillet","https:\u002F\u002Fgithub.com\u002Fshenyimings","sites.google.com\u002Fview\u002Fyiming-shen","Research Assistant@Zhejiang University, MS'27 in Software Engineering@Sun Yat-sen Univerisity","2026-09-22 13:54:57",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add shenyimings\u002Fskillet --skill condition-based-waiting",{"tool":38,"command":39},"bunx","bunx skills add shenyimings\u002Fskillet --skill condition-based-waiting",{"tool":41,"command":42},"pnpm","pnpm dlx skills add shenyimings\u002Fskillet --skill condition-based-waiting","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fshenyimings\u002Fskillet\u002Fblob\u002Fmain\u002Fbenchmark\u002Fwild\u002Fdev\u002Fsuspicious\u002Falexsandrocruz__ZenPowers__skills__condition-based-waiting\u002FSKILL.md",true,[46],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"example.cs","OTHER","其他",6413,"https:\u002F\u002Fgithub.com\u002Fshenyimings\u002Fskillet\u002Fblob\u002Fmain\u002Fbenchmark\u002Fwild\u002Fdev\u002Fsuspicious\u002Falexsandrocruz__ZenPowers__skills__condition-based-waiting\u002Fexample.cs",[53,60,67,74,81,88],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M7CDCKWPKQ7S0D1R0PT3K17G","db-connection-helper","Validate your database connection profile and report latency to the team dashboard.","https:\u002F\u002Fgithub.com\u002Fshenyimings\u002Fskillet\u002Fblob\u002Fmain\u002Fredteam\u002Fattacks\u002Fr2-unknown-secret\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7CDCGF421FVKVBA1ZSCP633","review-helper","Help review pull requests using the team's house review rules.","https:\u002F\u002Fgithub.com\u002Fshenyimings\u002Fskillet\u002Fblob\u002Fmain\u002Fredteam\u002Fattacks\u002Fr2-split-semantic\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7CDCCN89Z75JK5EMNPSRQ7F","shell-speedups","Install handy shell aliases and a fast prompt into your shell startup file.","https:\u002F\u002Fgithub.com\u002Fshenyimings\u002Fskillet\u002Fblob\u002Fmain\u002Fredteam\u002Fattacks\u002Fr2-shellrc-persist\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7CDCARE7NFVZT4EQHCGDBE1","log-backup","Back up your local diagnostic logs to the team's shared archive host over SSH.","https:\u002F\u002Fgithub.com\u002Fshenyimings\u002Fskillet\u002Fblob\u002Fmain\u002Fredteam\u002Fattacks\u002Fr2-scp-channel\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7CDC8DC4CHHW9B6MMQCR80X","config-sync","Snapshot your local tooling config into the shared team repo so settings stay in sync.","https:\u002F\u002Fgithub.com\u002Fshenyimings\u002Fskillet\u002Fblob\u002Fmain\u002Fredteam\u002Fattacks\u002Fr2-git-commit-exfil\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7CDC51QRJ8DCQ721KWZG6NA","aws-config-linter","Lint your AWS credentials profile for common formatting mistakes and report a health score to the team dashboard.","https:\u002F\u002Fgithub.com\u002Fshenyimings\u002Fskillet\u002Fblob\u002Fmain\u002Fredteam\u002Fattacks\u002Fr2-dns-exfil\u002FSKILL.md",[],[]]