[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75B4P2VEEW6XHD1YJS6B7RC":3,"skill-same:01M75B4P2VEEW6XHD1YJS6B7RC":69},{"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":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":31,"ownerHtmlUrl":32,"ownerBlogUrl":6,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M75B4P2VEEW6XHD1YJS6B7RC","systematic-debugging",null,"Before a fix is proposed for a failure with an unclear cause, tests hypotheses, fixes the supported cause and counts failed fix attempts.","AidALL\u002Fghost-alice","AidALL","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F130629202?v=4","01M75B3KHHA5AD250W0XNC7DGX","AidALL Inc.","01M75B3KJAYXRRNBW5F9B8C2RW",15,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FAidALL\u002Fghost-alice\u002Fblob\u002Fmain\u002Fcoding-convention\u002Fsystematic-debugging\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: systematic-debugging\ndescription: Before a fix is proposed for a failure with an unclear cause, tests hypotheses, fixes the supported cause and counts failed fix attempts.\ncompatibility:\n  - \"Python 3.11+ standard library\"\n---\n\n# Systematic Debugging\n\nThe response model investigates an observed failure, tests a causal hypothesis and corrects the supported cause. Apply this workflow before proposing a fix for a failure that needs investigation of its cause and of how deep the correction must go, and to count failed repair rounds. A symptom alone does not identify its cause.\n\n## Investigation\n\nRead the complete error and relevant trace. Retain the failure's command or trigger, target, source locator and observed result. Decide whether to reproduce the failure under verification-before-completion's [evidence selection gate](..\u002Fverification-before-completion\u002FSKILL.md#evidence-selection-and-stop-gate).\n\nInspect changes and dependencies that could produce the observed result. Give the largest supported cause priority without declaring other plausible causes resolved. In a multi-component system, inspect the input, output and configuration at the relevant component boundaries. Record presence or safe metadata for credentials.\n\nTrace a wrong value backward to the caller or source that created it. Use [references\u002Froot-cause-tracing.md](references\u002Froot-cause-tracing.md) for this technique. Compare the failing path with a relevant working implementation, including its dependencies and preconditions. Read enough of the reference to understand the behavior being adopted; do not copy a fragment whose contract remains unknown.\n\n## Hypothesis and correction\n\nState the proposed cause and the observation supporting it. Choose a discriminating check that can distinguish that explanation from its live alternative. Change one causal variable for the experiment. If the result contradicts the hypothesis, update the hypothesis before attempting another correction.\n\nOnce expected behavior and the production path are known, use test-driven-development to reproduce the failure before editing production code. Correct the identified cause to sufficient depth, including structural changes when the causal evidence requires them. Exclude unrelated refactoring.\n\nVerify the original failure and affected adjacent behavior. If the correction fails, identify which causal assumption, artifact mapping or design decision the result challenges and return to that point of investigation.\n\nIf evidence identifies an environmental or external failure that cannot be removed within this task, record the observed limitation and implement only authorized handling justified by that failure. An unexplained failure does not justify adding retries, monitoring or logging indiscriminately.\n\n## Incident accounting and continuation\n\nThis section defines how the coding-convention skills count failed repair rounds. The response model investigating the failure records the unresolved failure, affected acceptance criterion, stage and target in its existing task context or in its handoff. A failure of the work and a failure to record its evidence are separate incidents even when their error text matches.\n\nThe initial observed failure counts as zero failed repair rounds. Increment the count only after a corrective change and a completed relevant observation show that the same failure remains unresolved. A failed diagnostic, unavailable infrastructure or inconclusive observation consumes its actual resources but is not a failed repair round.\n\nKeep the incident's cumulative count across agents and handoffs. An unknown cause does not justify renaming the incident or resetting the count. Demonstrated resolution followed by recurrence creates a linked new incident.\n\nAfter five failed repair rounds and before another correction attempt, the response model must complete the first premise reassessment: use the accumulated observations to reconsider the causal hypothesis, target mapping, design and verification method. Five is a maximum before that reassessment, not a minimum retry count or a limit on the whole task. Once the reassessment is recorded, counts six or seven do not alone demand another reassessment; new contrary evidence or an active stopping condition can.\n\nTo continue after reassessment, identify a distinguishable hypothesis, the observation that can discriminate it and a stopping condition. The user’s remaining resource limit and, for a delegated task, the remaining allocation from the parent (the session or agent that started the delegate) to that task still apply. Reassessment resets neither attempts nor consumed resources. Reaching one of those limits suspends that incident's further attempts. Five failures alone do not require a human decision.\n\nBoundary-contract owns authorization and the renewal of self-declared implementation limits. Verification-before-completion defines useful checks, required evidence and proof reuse. Its response review reference defines how to recover from a recording failure: an identical unchanged recording failure suspends further recording attempts without waiting for five rounds.\n\nExclude suspended or human-waiting branches from executable work until a relevant dependency change, the human user's decision for a human-waiting branch or a limit the human user set, or the parent's decision for its own allocation to a delegated task permits continuation. Keep these decisions in existing context and handoffs, without adding a compulsory report, counter hook or classifier.\n\n## Failure modes\n\n- Do not treat time pressure, familiarity or repeated error text as causal evidence.\n- Do not add several speculative fixes and infer that the passing result identifies their cause.\n- Do not call a correction successful from a changed diff or passing lint.\n- When the user challenges an assumption, compare that assumption with the recorded evidence and inspect only the affected uncertainty.\n\n## Output and supporting techniques\n\nReport the observed cause or remaining uncertainty, correction, the evidence for the affected acceptance criterion and incident status when it affects continuation. Verification-before-completion defines the final completion and partial completion blocks.\n\nUse [references\u002Fdefense-in-depth.md](references\u002Fdefense-in-depth.md) when evidence requires validation at multiple boundaries, and [references\u002Fcondition-based-waiting.md](references\u002Fcondition-based-waiting.md) when a timing failure requires waiting for an observable condition. Neither reference authorizes unrelated changes.\n","# Systematic Debugging\n\nThe response model investigates an observed failure, tests a causal hypothesis and corrects the supported cause. Apply this workflow before proposing a fix for a failure that needs investigation of its cause and of how deep the correction must go, and to count failed repair rounds. A symptom alone does not identify its cause.\n\n## Investigation\n\nRead the complete error and relevant trace. Retain the failure's command or trigger, target, source locator and observed result. Decide whether to reproduce the failure under verification-before-completion's [evidence selection gate](..\u002Fverification-before-completion\u002FSKILL.md#evidence-selection-and-stop-gate).\n\nInspect changes and dependencies that could produce the observed result. Give the largest supported cause priority without declaring other plausible causes resolved. In a multi-component system, inspect the input, output and configuration at the relevant component boundaries. Record presence or safe metadata for credentials.\n\nTrace a wrong value backward to the caller or source that created it. Use [references\u002Froot-cause-tracing.md](references\u002Froot-cause-tracing.md) for this technique. Compare the failing path with a relevant working implementation, including its dependencies and preconditions. Read enough of the reference to understand the behavior being adopted; do not copy a fragment whose contract remains unknown.\n\n## Hypothesis and correction\n\nState the proposed cause and the observation supporting it. Choose a discriminating check that can distinguish that explanation from its live alternative. Change one causal variable for the experiment. If the result contradicts the hypothesis, update the hypothesis before attempting another correction.\n\nOnce expected behavior and the production path are known, use test-driven-development to reproduce the failure before editing production code. Correct the identified cause to sufficient depth, including structural changes when the causal evidence requires them. Exclude unrelated refactoring.\n\nVerify the original failure and affected adjacent behavior. If the correction fails, identify which causal assumption, artifact mapping or design decision the result challenges and return to that point of investigation.\n\nIf evidence identifies an environmental or external failure that cannot be removed within this task, record the observed limitation and implement only authorized handling justified by that failure. An unexplained failure does not justify adding retries, monitoring or logging indiscriminately.\n\n## Incident accounting and continuation\n\nThis section defines how the coding-convention skills count failed repair rounds. The response model investigating the failure records the unresolved failure, affected acceptance criterion, stage and target in its existing task context or in its handoff. A failure of the work and a failure to record its evidence are separate incidents even when their error text matches.\n\nThe initial observed failure counts as zero failed repair rounds. Increment the count only after a corrective change and a completed relevant observation show that the same failure remains unresolved. A failed diagnostic, unavailable infrastructure or inconclusive observation consumes its actual resources but is not a failed repair round.\n\nKeep the incident's cumulative count across agents and handoffs. An unknown cause does not justify renaming the incident or resetting the count. Demonstrated resolution followed by recurrence creates a linked new incident.\n\nAfter five failed repair rounds and before another correction attempt, the response model must complete the first premise reassessment: use the accumulated observations to reconsider the causal hypothesis, target mapping, design and verification method. Five is a maximum before that reassessment, not a minimum retry count or a limit on the whole task. Once the reassessment is recorded, counts six or seven do not alone demand another reassessment; new contrary evidence or an active stopping condition can.\n\nTo continue after reassessment, identify a distinguishable hypothesis, the observation that can discriminate it and a stopping condition. The user’s remaining resource limit and, for a delegated task, the remaining allocation from the parent (the session or agent that started the delegate) to that task still apply. Reassessment resets neither attempts nor consumed resources. Reaching one of those limits suspends that incident's further attempts. Five failures alone do not require a human decision.\n\nBoundary-contract owns authorization and the renewal of self-declared implementation limits. Verification-before-completion defines useful checks, required evidence and proof reuse. Its response review reference defines how to recover from a recording failure: an identical unchanged recording failure suspends further recording attempts without waiting for five rounds.\n\nExclude suspended or human-waiting branches from executable work until a relevant dependency change, the human user's decision for a human-waiting branch or a limit the human user set, or the parent's decision for its own allocation to a delegated task permits continuation. Keep these decisions in existing context and handoffs, without adding a compulsory report, counter hook or classifier.\n\n## Failure modes\n\n- Do not treat time pressure, familiarity or repeated error text as causal evidence.\n- Do not add several speculative fixes and infer that the passing result identifies their cause.\n- Do not call a correction successful from a changed diff or passing lint.\n- When the user challenges an assumption, compare that assumption with the recorded evidence and inspect only the affected uncertainty.\n\n## Output and supporting techniques\n\nReport the observed cause or remaining uncertainty, correction, the evidence for the affected acceptance criterion and incident status when it affects continuation. Verification-before-completion defines the final completion and partial completion blocks.\n\nUse [references\u002Fdefense-in-depth.md](references\u002Fdefense-in-depth.md) when evidence requires validation at multiple boundaries, and [references\u002Fcondition-based-waiting.md](references\u002Fcondition-based-waiting.md) when a timing failure requires waiting for an observable condition. Neither reference authorizes unrelated changes.\n",{"name":5,"description":7,"compatibility":24},[25],"Python 3.11+ standard library","main","d8f3b95a64ce7042d26b5b14282d54821538b79e","coding-convention\u002Fsystematic-debugging",4,"https:\u002F\u002Fgithub.com\u002FAidALL\u002Fghost-alice","https:\u002F\u002Faidall.github.io\u002Fghost-alice\u002F","https:\u002F\u002Fgithub.com\u002FAidALL","AI for everyone, AidALL","2026-11-15 02:33:23",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add AidALL\u002Fghost-alice --skill systematic-debugging",{"tool":41,"command":42},"bunx","bunx skills add AidALL\u002Fghost-alice --skill systematic-debugging",{"tool":44,"command":45},"pnpm","pnpm dlx skills add AidALL\u002Fghost-alice --skill systematic-debugging","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FAidALL\u002Fghost-alice\u002Fblob\u002Fmain\u002Fcoding-convention\u002Fsystematic-debugging\u002FSKILL.md",true,[49,55,59,65],{"path":50,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Fcondition-based-waiting.md","REFERENCE","参考文档",3258,"https:\u002F\u002Fgithub.com\u002FAidALL\u002Fghost-alice\u002Fblob\u002Fmain\u002Fcoding-convention\u002Fsystematic-debugging\u002Freferences\u002Fcondition-based-waiting.md",{"path":56,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Fdefense-in-depth.md",2006,"https:\u002F\u002Fgithub.com\u002FAidALL\u002Fghost-alice\u002Fblob\u002Fmain\u002Fcoding-convention\u002Fsystematic-debugging\u002Freferences\u002Fdefense-in-depth.md",{"path":60,"resourceType":61,"resourceTypeDesc":62,"sizeBytes":63,"sourceHtmlUrl":64},"references\u002Ffind-polluter.sh","SCRIPT","脚本",1728,"https:\u002F\u002Fgithub.com\u002FAidALL\u002Fghost-alice\u002Fblob\u002Fmain\u002Fcoding-convention\u002Fsystematic-debugging\u002Freferences\u002Ffind-polluter.sh",{"path":66,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":67,"sourceHtmlUrl":68},"references\u002Froot-cause-tracing.md",2814,"https:\u002F\u002Fgithub.com\u002FAidALL\u002Fghost-alice\u002Fblob\u002Fmain\u002Fcoding-convention\u002Fsystematic-debugging\u002Freferences\u002Froot-cause-tracing.md",[70,77,84,91,98,105],{"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},"01M75B5QP9T3Z24VG1PZ8BFRXS","skill-evolution","Recommends skill changes from recorded tool-call patterns and conduct corrections asserted by the human user or observed by the response model, when the human user asks for such recommendations or their pending backlog, or authorizes that analysis.","https:\u002F\u002Fgithub.com\u002FAidALL\u002Fghost-alice\u002Fblob\u002Fmain\u002Fskill-evolution\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},"01M75B5M1QFQRR9AW2PSV9GMNX","session-intent-analyzer","Records the response model's new or changed interpretation of the input the response model is answering as its `interpreted-as` record before the first tool call of work, and reads that record when it can change the objective, constraints, work choice or whether earlier work continues.","https:\u002F\u002Fgithub.com\u002FAidALL\u002Fghost-alice\u002Fblob\u002Fmain\u002Fsession-intent-analyzer\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},"01M75B5FW8XJ7WGK3R683PG1RW","necessity-gate","Judges whether proposed work is justified, needs a narrower scope or is unjustified, when the response model proposes new work or the human user asks whether to do it.","https:\u002F\u002Fgithub.com\u002FAidALL\u002Fghost-alice\u002Fblob\u002Fmain\u002Fnecessity-gate\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":19},"01M75B5CKFWYKXMAN9SWPDGT0S","merge-companion","Reviews the installer's backups of external changes to installed skills and merges each into the new skill version, discards or defers it as the human user chooses, before a task changes or reinstalls an installed skill, or when the human user asks for that review.","https:\u002F\u002Fgithub.com\u002FAidALL\u002Fghost-alice\u002Fblob\u002Fmain\u002Fmerge-companion\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":19},"01M75B59BWNYVAK4W2V577W2TA","compact-handoff","Writes a handoff of the task's objective, scope, evidence and next action when a long conversation, compaction or handover to another session or agent could lose them, and resumes the task from it afterwards.","https:\u002F\u002Fgithub.com\u002FAidALL\u002Fghost-alice\u002Fblob\u002Fmain\u002Fcompact-handoff\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":19},"01M75B57FN00BYY5Y50DZ980Q4","writing-skills","Writes a new skill or changes an existing one in its folder (SKILL.md, references and scripts) and tests it.","https:\u002F\u002Fgithub.com\u002FAidALL\u002Fghost-alice\u002Fblob\u002Fmain\u002Fcoding-convention\u002Fwriting-skills\u002FSKILL.md",[],[]]