[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M754RP7VKYSPFBKVQF1RZ3X5":3,"skill-same:01M754RP7VKYSPFBKVQF1RZ3X5":82},{"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":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M754RP7VKYSPFBKVQF1RZ3X5","codex-role-docs",null,"Use for role-scoped FE\u002FBE\u002FDevOps\u002FAdmin\u002FQA project docs under .codex\u002Fproject-docs to preserve micro-context across long projects.","Bang-isme\u002FAgencyCLI","Bang-isme","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F179383529?v=4","01M754NDM8K05SAX2V31R63WEE","01M754NDMV48ECFT4HY6X2CKQ0",2,"MIT","https:\u002F\u002Fgithub.com\u002FBang-isme\u002FAgencyCLI\u002Fblob\u002Fmain\u002Fpackages\u002Fcli\u002Fskills\u002Fcodex-role-docs\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: codex-role-docs\ndescription: Use for role-scoped FE\u002FBE\u002FDevOps\u002FAdmin\u002FQA project docs under .codex\u002Fproject-docs to preserve micro-context across long projects.\nload_priority: on-demand\n---\n\n## TL;DR\nUse this skill when a project needs durable FE\u002FBE\u002FDevOps\u002FAdmin\u002FQA context. Generate `.codex\u002Fproject-docs\u002F` once, then keep role docs updated as code changes.\n\n# Codex Role Docs\n\n## Activation\n\n1. Activate on `$role-docs`, `$init-docs`, or `$check-docs`.\n2. Activate when the user asks for project docs, role docs, technical documentation, architecture notes, API docs, UI\u002FUX docs, runbooks, or durable context.\n3. Activate during long-running projects where micro-context can be lost across sessions.\n4. Auto-use with agent personas when a role-owned file changes.\n\n## Core Rule\n\nRole docs are project-local artifacts, not always-loaded context. Read only the role docs needed for the current task, then update the same docs before completion when code behavior, contracts, architecture, UI patterns, deployment, admin flows, or tests changed.\n\n## Commands\n\n- Initialize docs: `init_role_docs.py --project-root \u003Cpath>`\n- Update one doc: `update_role_docs.py --project-root \u003Cpath> --role \u003Crole> --doc \u003Cdoc-id> --summary \u003Ctext> --files \u003Ccsv>`\n- Check impact: `check_role_docs.py --project-root \u003Cpath> --changed-files \u003Ccsv>`\n- Rebuild index: `build_role_docs_index.py --project-root \u003Cpath>`\n- See `skills\u002F.system\u002FREGISTRY.md` for full script paths.\n\n## Role Ownership\n\n| Role | Owns |\n| --- | --- |\n| `frontend-specialist` | `frontend\u002FFE-*`, admin UI flows, dashboards, reports |\n| `backend-specialist` | `backend\u002FBE-*`, admin permissions, contracts, data management |\n| `devops-engineer` | `devops\u002FDO-*` |\n| `test-engineer` | `qa\u002FQA-*` |\n| `security-auditor` | auth\u002Fsecurity, permissions, audit-log docs |\n| `planner` | project brief, ADR template, admin scope |\n\n## Update Discipline\n\n1. Before editing, check whether relevant docs exist under `.codex\u002Fproject-docs\u002F`.\n2. If missing and the task is project setup or planning, run `$init-docs`.\n3. After code changes, run `$check-docs` or map changed files manually.\n4. Update only the docs owned by the active agent's role.\n5. Keep entries factual: decision, source files, constraints, risks, verification.\n6. Do not block completion only because docs are missing unless the user explicitly made docs mandatory.\n\n## Generated Structure\n\n- `PROJECT-BRIEF.md`\n- `index.json`\n- `decisions\u002FADR-0001-template.md`\n- `frontend\u002FFE-*.md`\n- `backend\u002FBE-*.md`\n- `devops\u002FDO-*.md`\n- `admin\u002FAD-*.md`\n- `qa\u002FQA-*.md`\n\n## Resources\n\n- `templates\u002Frole_docs_manifest.json`: canonical role docs, owners, and doc metadata.\n- `templates\u002Fproject-brief-template.md`: project-level context template.\n- `templates\u002Frole-doc-template.md`: shared role-document template.\n- `templates\u002Fadr-template.md`: decision record template.\n","## TL;DR\nUse this skill when a project needs durable FE\u002FBE\u002FDevOps\u002FAdmin\u002FQA context. Generate `.codex\u002Fproject-docs\u002F` once, then keep role docs updated as code changes.\n\n# Codex Role Docs\n\n## Activation\n\n1. Activate on `$role-docs`, `$init-docs`, or `$check-docs`.\n2. Activate when the user asks for project docs, role docs, technical documentation, architecture notes, API docs, UI\u002FUX docs, runbooks, or durable context.\n3. Activate during long-running projects where micro-context can be lost across sessions.\n4. Auto-use with agent personas when a role-owned file changes.\n\n## Core Rule\n\nRole docs are project-local artifacts, not always-loaded context. Read only the role docs needed for the current task, then update the same docs before completion when code behavior, contracts, architecture, UI patterns, deployment, admin flows, or tests changed.\n\n## Commands\n\n- Initialize docs: `init_role_docs.py --project-root \u003Cpath>`\n- Update one doc: `update_role_docs.py --project-root \u003Cpath> --role \u003Crole> --doc \u003Cdoc-id> --summary \u003Ctext> --files \u003Ccsv>`\n- Check impact: `check_role_docs.py --project-root \u003Cpath> --changed-files \u003Ccsv>`\n- Rebuild index: `build_role_docs_index.py --project-root \u003Cpath>`\n- See `skills\u002F.system\u002FREGISTRY.md` for full script paths.\n\n## Role Ownership\n\n| Role | Owns |\n| --- | --- |\n| `frontend-specialist` | `frontend\u002FFE-*`, admin UI flows, dashboards, reports |\n| `backend-specialist` | `backend\u002FBE-*`, admin permissions, contracts, data management |\n| `devops-engineer` | `devops\u002FDO-*` |\n| `test-engineer` | `qa\u002FQA-*` |\n| `security-auditor` | auth\u002Fsecurity, permissions, audit-log docs |\n| `planner` | project brief, ADR template, admin scope |\n\n## Update Discipline\n\n1. Before editing, check whether relevant docs exist under `.codex\u002Fproject-docs\u002F`.\n2. If missing and the task is project setup or planning, run `$init-docs`.\n3. After code changes, run `$check-docs` or map changed files manually.\n4. Update only the docs owned by the active agent's role.\n5. Keep entries factual: decision, source files, constraints, risks, verification.\n6. Do not block completion only because docs are missing unless the user explicitly made docs mandatory.\n\n## Generated Structure\n\n- `PROJECT-BRIEF.md`\n- `index.json`\n- `decisions\u002FADR-0001-template.md`\n- `frontend\u002FFE-*.md`\n- `backend\u002FBE-*.md`\n- `devops\u002FDO-*.md`\n- `admin\u002FAD-*.md`\n- `qa\u002FQA-*.md`\n\n## Resources\n\n- `templates\u002Frole_docs_manifest.json`: canonical role docs, owners, and doc metadata.\n- `templates\u002Fproject-brief-template.md`: project-level context template.\n- `templates\u002Frole-doc-template.md`: shared role-document template.\n- `templates\u002Fadr-template.md`: decision record template.\n",{"name":5,"description":7,"load_priority":23},"on-demand","main","19b976c6b4f182f06d2d2e6b030549f2f8a69cc0","packages\u002Fcli\u002Fskills\u002Fcodex-role-docs",0,"https:\u002F\u002Fgithub.com\u002FBang-isme\u002FAgencyCLI","https:\u002F\u002Fgithub.com\u002FBang-isme","Hi my name is jeff","2026-07-15 19:58:17",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add Bang-isme\u002FAgencyCLI --skill codex-role-docs",{"tool":38,"command":39},"bunx","bunx skills add Bang-isme\u002FAgencyCLI --skill codex-role-docs",{"tool":41,"command":42},"pnpm","pnpm dlx skills add Bang-isme\u002FAgencyCLI --skill codex-role-docs","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FBang-isme\u002FAgencyCLI\u002Fblob\u002Fmain\u002Fpackages\u002Fcli\u002Fskills\u002Fcodex-role-docs\u002FSKILL.md",true,[46,52,56,60,64,70,74,78],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"scripts\u002Fbuild_role_docs_index.py","SCRIPT","脚本",3542,"https:\u002F\u002Fgithub.com\u002FBang-isme\u002FAgencyCLI\u002Fblob\u002Fmain\u002Fpackages\u002Fcli\u002Fskills\u002Fcodex-role-docs\u002Fscripts\u002Fbuild_role_docs_index.py",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"scripts\u002Fcheck_role_docs.py",11878,"https:\u002F\u002Fgithub.com\u002FBang-isme\u002FAgencyCLI\u002Fblob\u002Fmain\u002Fpackages\u002Fcli\u002Fskills\u002Fcodex-role-docs\u002Fscripts\u002Fcheck_role_docs.py",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"scripts\u002Finit_role_docs.py",6151,"https:\u002F\u002Fgithub.com\u002FBang-isme\u002FAgencyCLI\u002Fblob\u002Fmain\u002Fpackages\u002Fcli\u002Fskills\u002Fcodex-role-docs\u002Fscripts\u002Finit_role_docs.py",{"path":61,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":62,"sourceHtmlUrl":63},"scripts\u002Fupdate_role_docs.py",5500,"https:\u002F\u002Fgithub.com\u002FBang-isme\u002FAgencyCLI\u002Fblob\u002Fmain\u002Fpackages\u002Fcli\u002Fskills\u002Fcodex-role-docs\u002Fscripts\u002Fupdate_role_docs.py",{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"templates\u002Fadr-template.md","REFERENCE","参考文档",481,"https:\u002F\u002Fgithub.com\u002FBang-isme\u002FAgencyCLI\u002Fblob\u002Fmain\u002Fpackages\u002Fcli\u002Fskills\u002Fcodex-role-docs\u002Ftemplates\u002Fadr-template.md",{"path":71,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":72,"sourceHtmlUrl":73},"templates\u002Fproject-brief-template.md",606,"https:\u002F\u002Fgithub.com\u002FBang-isme\u002FAgencyCLI\u002Fblob\u002Fmain\u002Fpackages\u002Fcli\u002Fskills\u002Fcodex-role-docs\u002Ftemplates\u002Fproject-brief-template.md",{"path":75,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":76,"sourceHtmlUrl":77},"templates\u002Frole_docs_manifest.json",10269,"https:\u002F\u002Fgithub.com\u002FBang-isme\u002FAgencyCLI\u002Fblob\u002Fmain\u002Fpackages\u002Fcli\u002Fskills\u002Fcodex-role-docs\u002Ftemplates\u002Frole_docs_manifest.json",{"path":79,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":80,"sourceHtmlUrl":81},"templates\u002Frole-doc-template.md",426,"https:\u002F\u002Fgithub.com\u002FBang-isme\u002FAgencyCLI\u002Fblob\u002Fmain\u002Fpackages\u002Fcli\u002Fskills\u002Fcodex-role-docs\u002Ftemplates\u002Frole-doc-template.md",[83,90,97,104,111,118],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":18},"01M754T5CB6WCXB2AV8N0M50AC","codex-test-driven-development","Fixture stub for TDD skill.","https:\u002F\u002Fgithub.com\u002FBang-isme\u002FAgencyCLI\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fmock-skills\u002Fcodex-test-driven-development\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":18},"01M754T41J59TG0MJYC52TES58","codex-subagent-execution","Fixture stub for subagent execution skill.","https:\u002F\u002Fgithub.com\u002FBang-isme\u002FAgencyCLI\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fmock-skills\u002Fcodex-subagent-execution\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":18},"01M754T2JDSPA3YF83FK6BMNV6","codex-runtime-hook","Fixture stub for runtime hook skill.","https:\u002F\u002Fgithub.com\u002FBang-isme\u002FAgencyCLI\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fmock-skills\u002Fcodex-runtime-hook\u002FSKILL.md",[],[],{"skillNo":105,"name":106,"nameZh":6,"description":107,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":108,"categories":109,"keywords":110,"publishedAt":18},"01M754T1HG4JRTJVZC2PBFTXDT","codex-plan-writer","Fixture stub for plan writer skill.","https:\u002F\u002Fgithub.com\u002FBang-isme\u002FAgencyCLI\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fmock-skills\u002Fcodex-plan-writer\u002FSKILL.md",[],[],{"skillNo":112,"name":113,"nameZh":6,"description":114,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":18},"01M754SZJVZKGQR5PSA6YFFY09","codex-execution-quality-gate","Fixture stub for quality gate skill.","https:\u002F\u002Fgithub.com\u002FBang-isme\u002FAgencyCLI\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fmock-skills\u002Fcodex-execution-quality-gate\u002FSKILL.md",[],[],{"skillNo":119,"name":120,"nameZh":6,"description":121,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":122,"categories":123,"keywords":124,"publishedAt":18},"01M754SXBJ1DE0JR6TK0XJ4SAK","codex-demo","Minimal fixture skill for Agency CLI skill-md parser tests.","https:\u002F\u002Fgithub.com\u002FBang-isme\u002FAgencyCLI\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fmock-skills\u002Fcodex-demo\u002FSKILL.md",[],[]]