[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6HZPZ6E0N88TXZ9EX2DAGK7":3,"skill-same:01M6HZPZ6E0N88TXZ9EX2DAGK7":42},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":14,"categories":15,"keywords":16,"publishedAt":17,"linkOnly":18,"markdownContent":19,"markdownBody":19,"frontMatter":20,"refName":21,"commitSha":22,"skillDirectory":23,"forksCount":12,"repositoryHtmlUrl":24,"repositoryHomepageUrl":25,"ownerHtmlUrl":26,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":27,"install":28,"resources":41},"01M6HZPZ6E0N88TXZ9EX2DAGK7","ci",null,"Tatsh\u002Fwiswa","Tatsh","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F724848?v=4","01M6HZPX9FT9AY6CK9CWK82S26","01M6HZPXE07J6YKYW0KJFNFFRR",0,"MIT","https:\u002F\u002Fgithub.com\u002FTatsh\u002Fwiswa\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fci\u002FSKILL.md",[],[5],"2026-11-10 10:12:30",false,"# Commit\n\nCreate high-quality Git commits for all pending changes.\n\n## Gathering context\n\nRun these in parallel:\n\n1. `git diff` - unstaged changes.\n2. `git diff --cached` - staged changes.\n3. `git status` - untracked files and overall state.\n4. `git log --no-merges --format='%s%n%b---' -20 | grep -v '^bump:' | grep -iv dependabot` -\n   recent commit message style examples.\n\n## Running agents\n\nAfter gathering context but before committing, determine which agents to run based on the changed\nfiles. Launch each agent sequentially using the Agent tool with subagent_type `general-purpose`,\ntelling it to follow the corresponding `.claude\u002Fagents\u002F\u003Cname>.md` file. Scope each agent to only the\nchanged files, not the entire project.\n\nYou must skip any agents that are not relevant to the changed files (e.g. if no Click command files\nchanged, skip the click-auditor).\n\n### When Python code is being committed\n\nIf any changed files are under `wiswa\u002Ftool\u002F` or `tests\u002F`, run the following\nagents in parallel, having each agent report back with a list of suggested changes. After all agents\nhave completed, review their suggestions and apply them as appropriate. Then run the **qa-fixer**\nagent to format and fix any lint\u002Fspelling issues. Finally, run `yarn test:cov` to verify no\nregressions.\n\n1. **python-moderniser** - upgrade to modern Python features.\n1. **click-auditor** - validate Click command consistency. **Only run if the project directly uses\n   Click and files under `wiswa\u002Ftool\u002Fcommands\u002F` changed.**\n1. **docstring-fixer** - fix missing or incomplete docstrings.\n1. **copy-editor** - fix prose in comments, docstrings, and strings.\n1. **test-writer** - generate\u002Fupdate tests for new\u002Fchanged code. **Skip if the only changes are in\n   `tests\u002F`.**\n\n### When user-facing changes are being committed\n\n- **changelog** - update `CHANGELOG.md` only for **user-facing** changes (behaviour, CLI, public\n  API, security, or meaningful dependency constraints that affect installs). After it completes,\n  check if `CHANGELOG.md` was modified (`git diff CHANGELOG.md`). If it was, stage it with the\n  relevant commit. Follow `.claude\u002Fagents\u002Fchangelog.md`, including its skip list.\n\n  Files under `wiswa\u002Ftool\u002F`, `tests\u002F`, or version changes in `pyproject.toml` are **candidates**\n  for the changelog agent only when they **change what users see or\n  how the software behaves**. Editing those paths is not sufficient on its own.\n\n  **Skip the changelog agent** for workflows, CI config, `.claude\u002F`, documentation-only churn,\n  cruft or generator clean-up (for example replacing template placeholders such as `unknown` in\n  repository URLs, badges, packaging metadata, or `CODEOWNERS` with the real project identity),\n  internal refactors with no behaviour change, and other non-user-facing work.\n\n## Analysing changes\n\nGroup changed files by component. Determine if one commit or multiple\nlogical commits are needed.\n\n### Incidental files\n\nThe following files do not count when determining the component prefix, unless they are the **only**\nfile in a commit:\n\n- `CHANGELOG.md`\n- `.vscode\u002Fdictionary.txt`\n\nFor example, if a commit contains `wiswa\u002Ftool\u002Fcommands\u002Fmain.py`,\n`tests\u002Ftest_main_command.py`, and `CHANGELOG.md`, the component is determined by\nthe source files only. `CHANGELOG.md` is simply staged alongside them.\n\nIf `CHANGELOG.md` is the only file being committed, use the `changelog:` prefix. If\n`.vscode\u002Fdictionary.txt` is the only file, use `dictionary:` prefix.\n\n### When to split into multiple commits\n\n- Changes span unrelated components.\n- A refactor and a bug fix in the same file should be separate commits.\n- New tests for existing code should be separate from the code changes they test only if the code\n  changes are themselves separate.\n\n### Cruft updates\n\nWhen all changes are from re-running Wiswa (the project generator) and\nno hand-written code changed, this is a **cruft update**. Indicators:\n\n- Only Wiswa-managed files changed (workflows,\n  `package.json`, `pyproject.toml`, `.pre-commit-config.yaml`, `.claude\u002Fagents\u002F`, `.claude\u002Frules\u002F`,\n  `CITATION.cff`, `.vscode\u002Fdictionary.txt`, `uv.lock`,\n  `.wiswa.jsonnet`, etc.).\n- No files under the primary module or `tests\u002F` changed.\n\nCommit everything in a single commit with the subject `cruft: update`. Include a body summarising\nwhat changed (e.g. new\u002Fupdated workflows, updated agent files, dependency version bumps, new managed\nfiles). Do not run any agents. Do not split into multiple commits. Do not update the changelog.\n\n### When a single commit is fine\n\n- All changes serve the same purpose within a closely related set of files.\n- A bug fix and its test.\n\n## Commit message format\n\n```text\ncomponent.name: short description\n\nOptional longer description explaining the why, not the what. Wrap at 72\ncharacters.\n\nSigned-off-by: Author Name \u003Cemail>\nCloses: #123\n```\n\n### Subject line rules\n\n- Format: `component.name: short description`. Component name must be lowercase and must skip the\n  first period if present (`vscode` not `.vscode`, `README.md` -> `readme` not `README`), and must\n  omit the period with extension.\n- Lowercase after the colon (unless a proper noun).\n- No period at the end.\n- Maximum 72 characters.\n- Use imperative mood: 'add', 'fix', 'update', 'remove', not 'added', 'fixes', 'updated'.\n\n### Component prefix rules\n\nFor Python files, strip the `wiswa\u002Ftool\u002F` prefix and replace `\u002F` with `.` (like module imports).\n\n- Python file `wiswa\u002Ftool\u002Fmedia.py` → `media:`.\n- Multiple files under `wiswa\u002Ftool\u002Fcommands\u002F` → `commands:`.\n- Single command file `wiswa\u002Ftool\u002Fcommands\u002Fadmin.py` → `commands.admin:`.\n- Workflow file `.github\u002Fworkflows\u002Fqa.yml` → `workflows\u002Fqa:`.\n- Multiple workflows → `workflows\u002F*:`.\n- Agent files `.claude\u002Fagents\u002F*.md` → `.claude:` or specific agent name.\n- Instruction files across all 3 locations → `project:` (since they span Copilot\u002FCursor\u002FClaude).\n- Test files `tests\u002Ftest_media.py` → `tests\u002Ftest_media:` (or `tests:` for multiple).\n- Dictionary `.vscode\u002Fdictionary.txt` → `dictionary:` (only when committed alone).\n- Top-level config (`pyproject.toml`, `package.json`) → `project:`.\n- If changes span many unrelated areas → `project:`.\n- CHANGELOG.md → `changelog:` (only when committed alone).\n- CONTRIBUTING.md → `contributing:`.\n\n### Trailers\n\n- `Closes: #N` - when a commit closes an issue. If it is another project, use the full URI.\n- `Fixes: #N` - when a commit fixes a bug reported in an issue. If it is another project, use the\n  full URI.\n- `Related: #N` - when a commit is related to an issue but does not fully close or fix it. If it is\n  another project, use the full URI.\n- `Reviewed-by:` - if applicable.\n- `Co-authored-by:` - if applicable.\n- `Reported-by:`: - if applicable. Could get this information from a bug report that led to the fix\n  if the issue ID\u002FURL is known.\n- `Signed-off-by:` - always included on every commit. This will be added with `-s`.\n\n## Making commits\n\nRun commands separately. Do not chain commands with `&&` or `;`. Do not use scripts.\n\n1. Stage files for each logical commit using `git add` with specific file paths.\n2. If `CHANGELOG.md` was updated by the changelog agent, stage it with the relevant commit.\n3. Create the directory if it does not exist: `mkdir -p .wiswa-ci`. Skip if it already exists.\n4. Create a unique temp file with `mktemp .wiswa-ci\u002Fmessage-XXXXXXXX`. Write the commit message\n   there using the **Write** tool (not Bash `echo` or `cat`)\n5. Commit with `git commit -S -s -F \u003Ctempfile>` without using the\n   sandbox.\n6. If a pre-commit hook fails, fix the issue, re-stage (use appropriate agent if there is one), and\n   try to commit again.\n7. After all commits, run `git status` to verify clean state.\n\nTemp commit message files under `.wiswa-ci\u002F` do not need to be deleted after a successful commit; you\nmay leave them in place.\n\n## Rules\n\n- Never use `--no-verify` or `--no-gpg-sign`.\n- Amend the previous commit when the new change is logically part of it (e.g. same file, same\n  topic, fixing something just committed). Create a new commit when the change is distinct.\n- Never push unless explicitly asked.\n- Always use `-S` for GPG signing and `-s` for sign-off.\n- If there are no changes, do nothing.\n- Stage specific files, never use `git add -A` or `git add .`.\n",{},"master","b1935933a90b8d859d140f02d9a436899906f5a0",".claude\u002Fskills\u002Fci","https:\u002F\u002Fgithub.com\u002FTatsh\u002Fwiswa","https:\u002F\u002Ftatsh.github.io\u002Fwiswa\u002F","https:\u002F\u002Fgithub.com\u002FTatsh","2026-11-11 16:43:59",{"source":7,"skillName":5,"commands":29,"prompt":39,"zipAvailable":40},[30,33,36],{"tool":31,"command":32},"npx","npx skills add Tatsh\u002Fwiswa --skill ci",{"tool":34,"command":35},"bunx","bunx skills add Tatsh\u002Fwiswa --skill ci",{"tool":37,"command":38},"pnpm","pnpm dlx skills add Tatsh\u002Fwiswa --skill ci","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FTatsh\u002Fwiswa\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fci\u002FSKILL.md",true,[],[43,50,64],{"skillNo":44,"name":45,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":46,"categories":47,"keywords":48,"publishedAt":17},"01M6HZQ8579Z77A5DS08D1NC2P","regen","https:\u002F\u002Fgithub.com\u002FTatsh\u002Fwiswa\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fregen\u002FSKILL.md",[],[49],"Regen",{"skillNo":51,"name":52,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":60,"publishedAt":17},"01M6HZQ4MSKRM9RCCSJ49TTH87","prose-lint","https:\u002F\u002Fgithub.com\u002FTatsh\u002Fwiswa\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fprose-lint\u002FSKILL.md",[55],{"categoryNo":56,"categoryName":57,"taxonomyType":58,"taxonomyTypeDesc":59},"01JBSEEDCAT000000000000007","代码审查","SCENARIO","使用场景",[61,62,63],"lint","prose","prose lint",{"skillNo":65,"name":66,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":17},"01M6HZQ2D41X8YV1DQBJXDF4PF","make-release","https:\u002F\u002Fgithub.com\u002FTatsh\u002Fwiswa\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fmake-release\u002FSKILL.md",[],[70,71,72],"release","make","make release"]