[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7FEPJDMQ1XKMH155RWF7P27":3,"skill-same:01M7FEPJDMQ1XKMH155RWF7P27":43},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":28,"install":29,"resources":42},"01M7FEPJDMQ1XKMH155RWF7P27","python-change",null,"Implement or review a change to the Python package, its stub, its tests or the console script with the stubtest, pytest and wheel-smoke evidence the invariants require.","BiscuitBin\u002Falliumpy","BiscuitBin","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F345587809?v=4","01M7EB2YJH5XDMD513JY25JRH2","01M7FEPAEJ83F5AYQ4XK3D5QHA",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FBiscuitBin\u002Falliumpy\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fpython-change\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: python-change\ndescription: Implement or review a change to the Python package, its stub, its tests or the console script with the stubtest, pytest and wheel-smoke evidence the invariants require.\n---\n\n# Change the Python surface\n\n1. Read `AGENTS.md` and `crates\u002Falliumpy\u002Fpython\u002Falliumpy\u002F_alliumpy.pyi` first. The stub\n   is the canonical description of the Python API; what it does not describe does not\n   exist to a user of the extension.\n2. Decide where the change lands: a conversion or a constant belongs in the core\n   (`rust-change`); a class, function or exception exposed to Python belongs in\n   `crates\u002Falliumpy\u002Fsrc\u002Flib.rs`; a re-export belongs in `__init__.py`; the console\n   script is `_cli.py`. Its behaviour is upstream's (invariant 1), so a change there is\n   a parity change and goes through `just parity`.\n3. For an exposed API change, change the three artefacts together: the stub, the Rust\n   binding and the pytest case under `crates\u002Falliumpy\u002Ftests\u002F`. Write the pytest case\n   first and watch it fail against a rebuilt extension. The bindings crate has no\n   Rust tests; the core's unit tests and doctests stay in the core.\n4. Every class is `#[pyclass(frozen, eq, hash)]` and `Send + Sync`, with a `__repr__`\n   in `tickets\u002FCONVENTIONS.md` §9's form: for `Diagnostic`, every field in order,\n   `Diagnostic(line=1, col=2, severity='error', message='...', code=None)`, with\n   severity, message and code written as Python reprs. Every error reaches Python as\n   `AlliumError` with the stable `Display` text (invariant 3). Nothing derives\n   `__version__` from `ALLIUM_VERSION_STRING` or the reverse (decision 0010): package\n   metadata supplies the wheel's version, while upstream supplies the command's string.\n5. Run `just py-lint`, `just py-typecheck`, `just py-test`, `just py-stubtest`,\n   `just wheel-smoke` and `just version-check`, in that order, then `just check`.\n   A stubtest failure is a disagreement to resolve, never an allowlist entry without\n   a reason beside it. `just py-test` rebuilds the extension before running pytest.\n6. Report by `file:line`: what changed in the stub, binding and test, and which\n   upstream behaviour it reproduces.\n","# Change the Python surface\n\n1. Read `AGENTS.md` and `crates\u002Falliumpy\u002Fpython\u002Falliumpy\u002F_alliumpy.pyi` first. The stub\n   is the canonical description of the Python API; what it does not describe does not\n   exist to a user of the extension.\n2. Decide where the change lands: a conversion or a constant belongs in the core\n   (`rust-change`); a class, function or exception exposed to Python belongs in\n   `crates\u002Falliumpy\u002Fsrc\u002Flib.rs`; a re-export belongs in `__init__.py`; the console\n   script is `_cli.py`. Its behaviour is upstream's (invariant 1), so a change there is\n   a parity change and goes through `just parity`.\n3. For an exposed API change, change the three artefacts together: the stub, the Rust\n   binding and the pytest case under `crates\u002Falliumpy\u002Ftests\u002F`. Write the pytest case\n   first and watch it fail against a rebuilt extension. The bindings crate has no\n   Rust tests; the core's unit tests and doctests stay in the core.\n4. Every class is `#[pyclass(frozen, eq, hash)]` and `Send + Sync`, with a `__repr__`\n   in `tickets\u002FCONVENTIONS.md` §9's form: for `Diagnostic`, every field in order,\n   `Diagnostic(line=1, col=2, severity='error', message='...', code=None)`, with\n   severity, message and code written as Python reprs. Every error reaches Python as\n   `AlliumError` with the stable `Display` text (invariant 3). Nothing derives\n   `__version__` from `ALLIUM_VERSION_STRING` or the reverse (decision 0010): package\n   metadata supplies the wheel's version, while upstream supplies the command's string.\n5. Run `just py-lint`, `just py-typecheck`, `just py-test`, `just py-stubtest`,\n   `just wheel-smoke` and `just version-check`, in that order, then `just check`.\n   A stubtest failure is a disagreement to resolve, never an allowlist entry without\n   a reason beside it. `just py-test` rebuilds the extension before running pytest.\n6. Report by `file:line`: what changed in the stub, binding and test, and which\n   upstream behaviour it reproduces.\n",{"name":5,"description":7},"main","545e7f2fc9283cd30a64dc6c0eb9d88ce92b5f50",".agents\u002Fskills\u002Fpython-change","https:\u002F\u002Fgithub.com\u002FBiscuitBin\u002Falliumpy","https:\u002F\u002Fgithub.com\u002FBiscuitBin","2026-11-15 14:26:57",{"source":8,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add BiscuitBin\u002Falliumpy --skill python-change",{"tool":35,"command":36},"bunx","bunx skills add BiscuitBin\u002Falliumpy --skill python-change",{"tool":38,"command":39},"pnpm","pnpm dlx skills add BiscuitBin\u002Falliumpy --skill python-change","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FBiscuitBin\u002Falliumpy\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fpython-change\u002FSKILL.md",true,[],[44,51,58,65,70,77],{"skillNo":45,"name":46,"nameZh":6,"description":47,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":48,"categories":49,"keywords":50,"publishedAt":18},"01M7FEQWXGZJ5AK4ZMN1TWXVJF","rust-change","Implement or review a change to the core or the bindings crate with the layering, tests and documentation evidence the invariants require.","https:\u002F\u002Fgithub.com\u002FBiscuitBin\u002Falliumpy\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002Frust-change\u002FSKILL.md",[],[],{"skillNo":52,"name":53,"nameZh":6,"description":54,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":18},"01M7FEQSR6T3BT0QFHGR1STJWC","review-docs","Add or revise a handbook page so it satisfies the documentation contract and stays reachable.","https:\u002F\u002Fgithub.com\u002FBiscuitBin\u002Falliumpy\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002Freview-docs\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":18},"01M7FEQQMT1W6AJCD49DEVDEBJ","review-change","Review a change in this repository against its invariants, specifications, tests, and documentation contract.","https:\u002F\u002Fgithub.com\u002FBiscuitBin\u002Falliumpy\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002Freview-change\u002FSKILL.md",[],[],{"skillNo":66,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":18},"01M7FEQMVDNGECVDDZB0VKK6X1","https:\u002F\u002Fgithub.com\u002FBiscuitBin\u002Falliumpy\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002Fpython-change\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":18},"01M7FEQJXCX5NHEWQ2HR3W9FHM","project-check","Bring a workspace to a state where the full gate runs, and interpret what it reports.","https:\u002F\u002Fgithub.com\u002FBiscuitBin\u002Falliumpy\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002Fproject-check\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":18},"01M7FEQGSVXF12NJDFPAQ0BPZ9","plan-change","Plan a change when the scope, affected specifications, risks, or validation need evidence before any code is written.","https:\u002F\u002Fgithub.com\u002FBiscuitBin\u002Falliumpy\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002Fplan-change\u002FSKILL.md",[],[]]