[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M74FSX1B7BFH5CCX2FH6YFNC":3,"skill-same:01M74FSX1B7BFH5CCX2FH6YFNC":49},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":13,"repositoryHtmlUrl":25,"repositoryHomepageUrl":6,"ownerHtmlUrl":26,"ownerBlogUrl":6,"ownerDescription":27,"updatedAt":28,"install":29,"resources":42},"01M74FSX1B7BFH5CCX2FH6YFNC","comment-hygiene",null,"Astrumon\u002Fspovishun-skills","Astrumon","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F67917191?v=4","01M74FSGPFMM3XWY2PMSEN8Z2W","Danylo Bidnyk","01M74FSGQ12JX4QM4FEY6NEH6N",0,"MIT","https:\u002F\u002Fgithub.com\u002FAstrumon\u002Fspovishun-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcomment-hygiene\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"# Comment Hygiene\n\nRemoves comments that read as generically AI-generated (decorative, restating the obvious,\nnarrating, loud) from the **task diff**, and keeps the comments that carry information the code\ndoes not show. Proposes edits as a diff, applies them only after the user confirms, verifies that\nnothing but comments changed, and never commits.\n\n**Scope guardrail.** This skill changes comments only. Never modify executable code, identifiers,\nimports, annotations, formatting, indentation, control flow or logic. When in doubt, leave the\ncomment alone — a surviving weak comment costs less than a broken build.\n\n## Workflow\n\n### Step 1: Collect candidates from the task diff\n\n```\ngit diff -U0 {{GIT_DEVELOP_BRANCH}}...HEAD\n```\n(If `{{GIT_DEVELOP_BRANCH}}` is empty, default to `develop`.)\n\nA candidate is a comment on a `+` line of that diff: a line comment, a block or KDoc comment, or\nthe trailing comment part of a code line. Comments outside the diff are out of bounds, even when\nthey are noisy — this pass cleans up the task, not the codebase.\n\nThen run `git status --porcelain`. A candidate file with **uncommitted changes** is skipped and\nnamed in the report: the rollback in Step 4 restores a file to `HEAD`, which is only safe when\nthe file had nothing else uncommitted.\n\n### Step 2: Drop the allowlist — never touched\n\nBefore judging anything, remove these from the candidate set. They are directives read by tools,\nor legal text, and removing one breaks the build, the IDE or the licence:\n\n- `\u002F\u002F region` \u002F `\u002F\u002F endregion` (IDE folding)\n- `\u002F\u002F language=…` (IntelliJ language injection, e.g. `\u002F\u002F language=SQL`)\n- `\u002F\u002Fnoinspection …`\n- `\u002F\u002F @formatter:off` \u002F `\u002F\u002F @formatter:on`\n- `\u002F\u002F ktlint-disable …`, `\u002F* ktlint-disable *\u002F`, `\u002F\u002F ktlint-enable …`\n- detekt suppressions, and the comment justifying an `@Suppress(...)` annotation\n- license and copyright headers (any comment containing `license`, `copyright`, `SPDX-License-Identifier`)\n- every comment in a DB migration file (`**\u002Fdb\u002Fmigration\u002F**`, any `*.sql`) — Flyway checksums the\n  whole file, so a comment edit in an applied migration fails validation\n\n### Step 3: Judge the rest, then propose\n\nMatch each remaining candidate against **Tells** below and keep everything under **Preserve**.\nPresent the proposed changes as one unified diff in chat, grouped by file, with the tell named for\neach hunk. If nothing qualifies, say so and stop.\n\nApply with `Edit` **only after the user explicitly confirms**. A partial confirmation (\"only the\nbanners\") applies only that part.\n\n### Step 4: Comment-only check\n\nAfter applying, verify every touched file:\n```\ngit diff -U0 -- \u003Cfile>\n```\nFor each hunk, strip the comment part from every `-` and `+` line (`\u002F\u002F …` to end of line, `\u002F* … *\u002F`,\nKDoc lines starting with `*`). Pass when:\n\n- the remaining code on the `-` side and the `+` side is **byte-identical**, line for line, and\n- every line that disappeared entirely was a comment line or a blank line left by a removed comment.\n\nOn a failure, restore that file — and only that file — with `git restore -- \u003Cfile>`, then report the\noffending hunk. Step 1 guaranteed the file had no other uncommitted changes, so nothing of the\nuser's is lost.\n\n### Step 5: Report in {{PROJECT_LANGUAGE}}\n\nWrite the report in the project language `{{PROJECT_LANGUAGE}}` (`uk` is Ukrainian, `en` English):\ncounts per tell, allowlisted comments that were kept, skipped files and why, and any file restored\nby Step 4. Never commit. Point out that the edits are uncommitted.\n\n## Tells\n\nEach entry is **Tell** (the pattern), **Why** (why it reads as noise), **Fix**.\n\n**Decorative separators.** Tell: `\u002F\u002F ===== REPOSITORY =====`, `\u002F\u002F -------- MAPPERS --------`,\n`\u002F* ---- ROUTES ---- *\u002F`. Why: the decoration is the message; ALL CAPS reads as shouting. Fix: one\nplain line, or remove if the label adds nothing. A `\u002F\u002F region` is a directive, not a banner — keep it.\n\n**Restating the obvious.** Tell: `\u002F\u002F Create the repository` above `val repository = UserRepository(db)`,\n`\u002F\u002F User entity` above `data class User(...)`. Why: doubles the reading load. Fix: remove.\n\n**Workflow narration.** Tell: inside a `suspend fun`, `\u002F\u002F Step 1: Validate input`,\n`\u002F\u002F Step 2: Load user`, `\u002F\u002F Step 3: Emit result`, or `\u002F\u002F First…` \u002F `\u002F\u002F Finally…`. Why: the sequence is\nvisible in the code; numbering reads as a checklist. Fix: remove. If the flow is hard to follow, that\nis a structure problem, not a missing comment.\n\n**Empty labels.** Tell: `\u002F\u002F Main logic`, `\u002F\u002F Helper function`, `\u002F\u002F Error handling`,\n`\u002F\u002F Note: this is important`. Why: names a category, not a fact. Fix: remove unless it carries one —\n`\u002F\u002F Note: retries only on 5xx` stays.\n\n**Vague placeholders.** Tell: `\u002F\u002F TODO: improve`, `\u002F\u002F TODO: add more validation`,\n`\u002F\u002F Future optimizations`. Why: names a feeling, not a task. Fix: remove. Keep a TODO that names what\nto do and why.\n\n**Signature echo.** Tell:\n```kotlin\n\u002F**\n * Finds a user by id.\n * @param id the id\n * @return the user\n *\u002F\nsuspend fun findById(id: UserId): User?\n```\nWhy: restates the signature and adds length, not understanding. Fix: remove the echo. Keep KDoc that\ndocuments business rules, edge cases (`@return null when the user was soft-deleted`), thrown\nexceptions, side effects, threading or a public API contract.\n\n**Decorative emoji.** Tell: `\u002F\u002F ✅ Validation`, `\u002F\u002F 🚀 Fast path`. Fix: plain words, or remove.\n\n**End markers.** Tell: `} \u002F\u002F end if`, `} \u002F\u002F end of processOrder`. Why: the brace already ends the\nblock. Fix: remove the trailing comment; the `}` stays exactly as it was.\n\n**Over-explained comment.** Tell: four lines of history, issue numbers and a \"because X, so Y\" chain\naround a one-line constraint. Fix: cut to the constraint — one line, two at most. Keep the trap, the\nsilent failure, the protocol rule; drop the history.\n\n**Line-by-line narration.** Tell: a comment on every trivial statement. Fix: at most one comment per\nlogical block; none if the block needs none.\n\n**Stiff or loud wording.** Tell: \"This function is responsible for validating whether the supplied\ncredentials are valid before…\", or `\u002F\u002F MAIN LOGIC`. Fix: a short sentence-case line in a developer's\nvoice, saying why rather than what.\n\n## Preserve\n\nNever remove a comment that explains business logic and intent, an architectural decision, security,\na performance trade-off, concurrency behaviour (dispatcher choice, cancellation, a `Mutex`), a\nprotocol detail, an API contract, a workaround, an edge case or assumption, or licensing. It must stay:\n```kotlin\n\u002F\u002F Telegram retries webhook delivery on any non-2xx; dedupe by update_id.\n```\nEarning a place says what may stay, not how long it may run — a valuable comment can still be\nshortened to its constraint.\n\n## Checklist\n\nAll answers must be **yes** before proposing:\n\n- [ ] Every candidate came from the task diff, and no allowlisted comment is in the proposal.\n- [ ] Every remaining comment adds information the code does not already show.\n- [ ] No decorative separators, step narration, empty labels, vague TODOs, signature echo, emoji or\n      end markers survive in the diff.\n- [ ] Every comment is one line, or two when the second carries a new fact.\n- [ ] Only comments change — the Step 4 check will pass.\n\n## Do NOT\n\n- Do **not** touch a comment outside the task diff, or any allowlisted comment.\n- Do **not** apply edits without explicit confirmation, and do **not** commit them.\n- Do **not** ask the user to pick a mode before running — this pass runs inside non-interactive\n  flows such as `finish-task`; the one question it asks is the confirmation in Step 3.\n- Do **not** turn this into a review: no severity levels, no findings about the code. Code review\n  belongs to `code-reviewer`.\n\n## Related Skills\n\n- `finish-task` — runs this pass as its non-blocking Step 2b, before the blocking gate.\n- `commit` — committing the confirmed comment edits.\n- `code-reviewer` — reviews the code; this skill reviews nothing but comments.\n",{},"main","4ad702b3d4f403306c1a016277020693dd669f55","skills\u002Fcomment-hygiene","https:\u002F\u002Fgithub.com\u002FAstrumon\u002Fspovishun-skills","https:\u002F\u002Fgithub.com\u002FAstrumon","Software Engineer","2026-10-14 01:01:46",{"source":7,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add Astrumon\u002Fspovishun-skills --skill comment-hygiene",{"tool":35,"command":36},"bunx","bunx skills add Astrumon\u002Fspovishun-skills --skill comment-hygiene",{"tool":38,"command":39},"pnpm","pnpm dlx skills add Astrumon\u002Fspovishun-skills --skill comment-hygiene","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FAstrumon\u002Fspovishun-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcomment-hygiene\u002FSKILL.md",true,[43],{"path":44,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":47,"sourceHtmlUrl":48},"manifest.yaml","REFERENCE","参考文档",1177,"https:\u002F\u002Fgithub.com\u002FAstrumon\u002Fspovishun-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcomment-hygiene\u002Fmanifest.yaml",[50,56,62,69,74,79],{"skillNo":51,"name":52,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":18},"01M74FX71JH2KNG5KX7TZHSKCB","universal-skill","https:\u002F\u002Fgithub.com\u002FAstrumon\u002Fspovishun-skills\u002Fblob\u002Fmain\u002Ftest\u002Ffixtures\u002Fsource\u002Fskills\u002Funiversal-skill\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":18},"01M74FX57GTEFPJVCPWPSP6CCW","notion-skill","https:\u002F\u002Fgithub.com\u002FAstrumon\u002Fspovishun-skills\u002Fblob\u002Fmain\u002Ftest\u002Ffixtures\u002Fsource\u002Fskills\u002Fnotion-skill\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":18},"01M74FX30F3K8906P5ASQ3DNXR","inline-frontmatter-skill","Hand-authored description that already lives in the body and must not be double-wrapped.","https:\u002F\u002Fgithub.com\u002FAstrumon\u002Fspovishun-skills\u002Fblob\u002Fmain\u002Ftest\u002Ffixtures\u002Fsource\u002Fskills\u002Finline-frontmatter-skill\u002FSKILL.md",[],[],{"skillNo":70,"name":52,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M74FX18AGHM2KHQ502PMJZRJ","https:\u002F\u002Fgithub.com\u002FAstrumon\u002Fspovishun-skills\u002Fblob\u002Fmain\u002Ftest\u002Ffixtures\u002Fsource-v2\u002Fskills\u002Funiversal-skill\u002FSKILL.md",[],[],{"skillNo":75,"name":58,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":18},"01M74FWZJ193G810P0ZJ1PKEZ9","https:\u002F\u002Fgithub.com\u002FAstrumon\u002Fspovishun-skills\u002Fblob\u002Fmain\u002Ftest\u002Ffixtures\u002Fsource-v2\u002Fskills\u002Fnotion-skill\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":18},"01M74FWPNEZWWGQ2Q37N6MMWP1","write-a-skill","https:\u002F\u002Fgithub.com\u002FAstrumon\u002Fspovishun-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwrite-a-skill\u002FSKILL.md",[],[]]