[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6AD2S11158M4XYQH7WA7PSG":3,"skill-same:01M6AD2S11158M4XYQH7WA7PSG":78},{"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":30,"linkOnly":31,"markdownContent":32,"markdownBody":33,"frontMatter":34,"refName":35,"commitSha":36,"skillDirectory":37,"forksCount":38,"repositoryHtmlUrl":39,"repositoryHomepageUrl":40,"ownerHtmlUrl":41,"ownerBlogUrl":42,"ownerDescription":6,"updatedAt":43,"install":44,"resources":57},"01M6AD2S11158M4XYQH7WA7PSG","translate-docs-zh",null,"Translate Apache Fory docs into Simplified Chinese and maintain existing Chinese translations by diffing English source changes. Use when asked to translate docs, sync i18n\u002Fzh-CN content, remove placeholder Chinese-intro notices, or update already-translated files after English docs changed. Strict rule: do NOT use any external translation service, API, website, or translation CLI tool; translation must be done directly by Codex.","apache\u002Ffory-site","apache","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F47359?v=4","01M6AC83E6K4FDKK7HZ8WNMQKE","The Apache Software Foundation","01M6AD2JPPK02F19VRCPF0M3PK",30,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fapache\u002Ffory-site\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftranslate-docs-zh\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,9,27,28,29],"docs","translate","translate docs zh","cli","codex","sync","placeholder","update","content","website","fory","2026-11-10 10:12:30",false,"---\nname: translate-docs-zh\ndescription: >-\n  Translate Apache Fory docs into Simplified Chinese and maintain existing\n  Chinese translations by diffing English source changes. Use when asked to\n  translate docs, sync i18n\u002Fzh-CN content, remove placeholder Chinese-intro\n  notices, or update already-translated files after English docs changed.\n  Strict rule: do NOT use any external translation service, API, website, or\n  translation CLI tool; translation must be done directly by Codex.\n---\n\n# Translate Docs (zh-CN)\n\nTranslate documentation into Simplified Chinese and keep existing Chinese docs aligned with English source updates.\n\n## Hard Constraints\n\n- Do not call external translation tools.\n- Do not use translation websites\u002Fservices\u002FAPIs (Google\u002FBaidu\u002FDeepL\u002FYoudao\u002FOpenAI translation API wrappers, etc.).\n- Do not use local translation CLIs or plugins.\n- Translate directly in-place by Codex reasoning and editing only.\n\n## Terminology Reference (Required)\n\n- Always apply the terminology standard in `references\u002Fterminology.md`.\n- If existing Chinese wording conflicts with the terminology table, normalize to the table unless user explicitly requests otherwise.\n- For newly introduced English terms, append a proposed entry to the terminology table when the term is likely to recur.\n\n## Path Mapping\n\nMap source and target paths with these rules:\n\n1. Current docs:\n\n- Source: `docs\u002F\u003Csubpath>.md`\n- Target: `i18n\u002Fzh-CN\u002Fdocusaurus-plugin-content-docs\u002Fcurrent\u002F\u003Csubpath>.md`\n\n2. Versioned docs:\n\n- Source: `versioned_docs\u002Fversion-X\u002F\u003Csubpath>.md`\n- Target: `i18n\u002Fzh-CN\u002Fdocusaurus-plugin-content-docs\u002Fversion-X\u002F\u003Csubpath>.md`\n\n3. Category labels:\n\n- Source: `docs\u002F**\u002F_category_.json`\n- Target: `i18n\u002Fzh-CN\u002Fdocusaurus-plugin-content-docs\u002F**\u002F_category_.json`\n\n4. Sidebar top-level label i18n keys:\n\n- Target: `i18n\u002Fzh-CN\u002Fdocusaurus-plugin-content-docs\u002Fcurrent.json`\n- Optional version keys: `i18n\u002Fzh-CN\u002Fdocusaurus-plugin-content-docs\u002Fversion-*.json`\n\n## Workflow\n\n### Step 1: Discover file pairs\n\n1. Build source-target pairs from user scope.\n2. If user gives only Chinese targets, infer matching English source by reverse mapping.\n3. Skip pairs whose source file does not exist; report them clearly.\n\n### Step 2: Classify each Chinese file\n\nClassify as `untranslated` or `translated`.\n\nTreat as `untranslated` if any condition is true:\n\n- Target file missing.\n- Contains placeholder notices like `中文导读` \u002F `中文章节导读`.\n- Non-code prose is mostly English.\n- Headings\u002Fbody are largely English while only title\u002Ffrontmatter is Chinese.\n\nOtherwise classify as `translated`.\n\n### Step 3A: Handle untranslated files (full translation)\n\n1. Translate the entire document from current English source.\n2. Keep frontmatter keys and structure valid.\n3. Keep identifiers\u002Fcode\u002Fprotocol fields\u002FCLI flags in English.\n4. Translate headings, prose, table descriptions, and comments meant for readers.\n5. Remove placeholder intro notices (`中文导读` style blocks).\n6. Preserve link targets and anchors unless a better Chinese heading requires an explicit anchor.\n\n### Step 3B: Handle translated files (diff-based maintenance)\n\n1. Find source changes since last Chinese update baseline.\n2. Prefer this baseline method:\n\n- `zh_last_commit = git log -1 --format=%H -- \u003Czh_file>`\n- `git diff --unified=0 \u003Czh_last_commit>..HEAD -- \u003Csource_file>`\n\n3. If no source diff, keep Chinese file unchanged.\n4. If source diff exists, decide update strategy:\n\nUse **partial update** when all are true:\n\n- Changes are local and limited.\n- Document structure mostly unchanged.\n- No widespread terminology shifts.\n\nUse **full rewrite** when any is true:\n\n- Large structural edits (section reordering\u002Fsplitting\u002Fmerging).\n- Significant rewrite of core semantics.\n- Many scattered edits across the document.\n- Existing Chinese wording quality is inconsistent or outdated.\n\n5. Apply translations only for changed semantics; keep unaffected Chinese content stable.\n6. If full rewrite is chosen, regenerate complete Chinese content from latest English source.\n\n## Translation Quality Rules\n\n1. Prioritize semantic correctness over literal wording.\n2. Keep terminology consistent across files.\n3. Avoid awkward literal phrases (for example avoid unnatural jargon calques).\n4. Keep technical precision:\n\n- Distinguish encoding format vs transport framework concepts.\n- Keep units, ranges, and bit layouts exact.\n\n5. Preserve examples and command behavior exactly.\n\n## Validation Checklist\n\nRun checks after edits:\n\n1. Placeholder cleanup:\n\n- `rg -n \"中文导读|中文章节导读\" i18n\u002Fzh-CN -S`\n\n2. Markdown integrity:\n\n- Ensure code fences are balanced.\n- Ensure tables render (pipes\u002Falignment valid).\n- Ensure frontmatter remains valid YAML.\n\n3. MDX safety:\n\n- Avoid standalone lines that MDX may parse as ESM (`import ...`, `export ...`) in prose.\n\n4. Link\u002Fanchor sanity:\n\n- Preserve existing inbound anchors where possible.\n\n5. Optional build verification (recommended):\n\n- `npm run build -- --locale zh-CN`\n\n## Decision Heuristics for Rewrite vs Patch\n\nUse this pragmatic threshold (guide, not absolute):\n\n- Patch when source changed prose is small and localized.\n- Rewrite when changed prose is broad, central, or distributed across many sections.\n\nWhen uncertain, prefer full rewrite for short\u002Fmedium docs and targeted patch for very large docs with clearly isolated changes.\n\n## Output Requirements for the user\n\nReport clearly:\n\n1. Files fully translated.\n2. Files partially updated by source diff.\n3. Files fully rewritten due to large source changes.\n4. Validation results and any unresolved risks.\n","# Translate Docs (zh-CN)\n\nTranslate documentation into Simplified Chinese and keep existing Chinese docs aligned with English source updates.\n\n## Hard Constraints\n\n- Do not call external translation tools.\n- Do not use translation websites\u002Fservices\u002FAPIs (Google\u002FBaidu\u002FDeepL\u002FYoudao\u002FOpenAI translation API wrappers, etc.).\n- Do not use local translation CLIs or plugins.\n- Translate directly in-place by Codex reasoning and editing only.\n\n## Terminology Reference (Required)\n\n- Always apply the terminology standard in `references\u002Fterminology.md`.\n- If existing Chinese wording conflicts with the terminology table, normalize to the table unless user explicitly requests otherwise.\n- For newly introduced English terms, append a proposed entry to the terminology table when the term is likely to recur.\n\n## Path Mapping\n\nMap source and target paths with these rules:\n\n1. Current docs:\n\n- Source: `docs\u002F\u003Csubpath>.md`\n- Target: `i18n\u002Fzh-CN\u002Fdocusaurus-plugin-content-docs\u002Fcurrent\u002F\u003Csubpath>.md`\n\n2. Versioned docs:\n\n- Source: `versioned_docs\u002Fversion-X\u002F\u003Csubpath>.md`\n- Target: `i18n\u002Fzh-CN\u002Fdocusaurus-plugin-content-docs\u002Fversion-X\u002F\u003Csubpath>.md`\n\n3. Category labels:\n\n- Source: `docs\u002F**\u002F_category_.json`\n- Target: `i18n\u002Fzh-CN\u002Fdocusaurus-plugin-content-docs\u002F**\u002F_category_.json`\n\n4. Sidebar top-level label i18n keys:\n\n- Target: `i18n\u002Fzh-CN\u002Fdocusaurus-plugin-content-docs\u002Fcurrent.json`\n- Optional version keys: `i18n\u002Fzh-CN\u002Fdocusaurus-plugin-content-docs\u002Fversion-*.json`\n\n## Workflow\n\n### Step 1: Discover file pairs\n\n1. Build source-target pairs from user scope.\n2. If user gives only Chinese targets, infer matching English source by reverse mapping.\n3. Skip pairs whose source file does not exist; report them clearly.\n\n### Step 2: Classify each Chinese file\n\nClassify as `untranslated` or `translated`.\n\nTreat as `untranslated` if any condition is true:\n\n- Target file missing.\n- Contains placeholder notices like `中文导读` \u002F `中文章节导读`.\n- Non-code prose is mostly English.\n- Headings\u002Fbody are largely English while only title\u002Ffrontmatter is Chinese.\n\nOtherwise classify as `translated`.\n\n### Step 3A: Handle untranslated files (full translation)\n\n1. Translate the entire document from current English source.\n2. Keep frontmatter keys and structure valid.\n3. Keep identifiers\u002Fcode\u002Fprotocol fields\u002FCLI flags in English.\n4. Translate headings, prose, table descriptions, and comments meant for readers.\n5. Remove placeholder intro notices (`中文导读` style blocks).\n6. Preserve link targets and anchors unless a better Chinese heading requires an explicit anchor.\n\n### Step 3B: Handle translated files (diff-based maintenance)\n\n1. Find source changes since last Chinese update baseline.\n2. Prefer this baseline method:\n\n- `zh_last_commit = git log -1 --format=%H -- \u003Czh_file>`\n- `git diff --unified=0 \u003Czh_last_commit>..HEAD -- \u003Csource_file>`\n\n3. If no source diff, keep Chinese file unchanged.\n4. If source diff exists, decide update strategy:\n\nUse **partial update** when all are true:\n\n- Changes are local and limited.\n- Document structure mostly unchanged.\n- No widespread terminology shifts.\n\nUse **full rewrite** when any is true:\n\n- Large structural edits (section reordering\u002Fsplitting\u002Fmerging).\n- Significant rewrite of core semantics.\n- Many scattered edits across the document.\n- Existing Chinese wording quality is inconsistent or outdated.\n\n5. Apply translations only for changed semantics; keep unaffected Chinese content stable.\n6. If full rewrite is chosen, regenerate complete Chinese content from latest English source.\n\n## Translation Quality Rules\n\n1. Prioritize semantic correctness over literal wording.\n2. Keep terminology consistent across files.\n3. Avoid awkward literal phrases (for example avoid unnatural jargon calques).\n4. Keep technical precision:\n\n- Distinguish encoding format vs transport framework concepts.\n- Keep units, ranges, and bit layouts exact.\n\n5. Preserve examples and command behavior exactly.\n\n## Validation Checklist\n\nRun checks after edits:\n\n1. Placeholder cleanup:\n\n- `rg -n \"中文导读|中文章节导读\" i18n\u002Fzh-CN -S`\n\n2. Markdown integrity:\n\n- Ensure code fences are balanced.\n- Ensure tables render (pipes\u002Falignment valid).\n- Ensure frontmatter remains valid YAML.\n\n3. MDX safety:\n\n- Avoid standalone lines that MDX may parse as ESM (`import ...`, `export ...`) in prose.\n\n4. Link\u002Fanchor sanity:\n\n- Preserve existing inbound anchors where possible.\n\n5. Optional build verification (recommended):\n\n- `npm run build -- --locale zh-CN`\n\n## Decision Heuristics for Rewrite vs Patch\n\nUse this pragmatic threshold (guide, not absolute):\n\n- Patch when source changed prose is small and localized.\n- Rewrite when changed prose is broad, central, or distributed across many sections.\n\nWhen uncertain, prefer full rewrite for short\u002Fmedium docs and targeted patch for very large docs with clearly isolated changes.\n\n## Output Requirements for the user\n\nReport clearly:\n\n1. Files fully translated.\n2. Files partially updated by source diff.\n3. Files fully rewritten due to large source changes.\n4. Validation results and any unresolved risks.\n",{"name":5,"description":7},"main","8e6de8ae860d95771a20eabcbb7baca9f0409acc",".claude\u002Fskills\u002Ftranslate-docs-zh",38,"https:\u002F\u002Fgithub.com\u002Fapache\u002Ffory-site","https:\u002F\u002Ffory.apache.org\u002F","https:\u002F\u002Fgithub.com\u002Fapache","https:\u002F\u002Fwww.apache.org\u002F","2026-11-14 12:23:05",{"source":8,"skillName":5,"commands":45,"prompt":55,"zipAvailable":56},[46,49,52],{"tool":47,"command":48},"npx","npx skills add apache\u002Ffory-site --skill translate-docs-zh",{"tool":50,"command":51},"bunx","bunx skills add apache\u002Ffory-site --skill translate-docs-zh",{"tool":53,"command":54},"pnpm","pnpm dlx skills add apache\u002Ffory-site --skill translate-docs-zh","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fapache\u002Ffory-site\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftranslate-docs-zh\u002FSKILL.md",true,[58,64,68,74],{"path":59,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":62,"sourceHtmlUrl":63},"references\u002Fposting.md","REFERENCE","参考文档",1465,"https:\u002F\u002Fgithub.com\u002Fviktomas\u002Fdotfiles\u002Fblob\u002Fmaster\u002Fagents\u002F.agents\u002Fskills\u002Freview\u002Freferences\u002Fposting.md",{"path":65,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":66,"sourceHtmlUrl":67},"references\u002Fterminology.md",6223,"https:\u002F\u002Fgithub.com\u002Fapache\u002Ffory-site\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftranslate-docs-zh\u002Freferences\u002Fterminology.md",{"path":69,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":72,"sourceHtmlUrl":73},"scripts\u002Fget-mr-context.sh","SCRIPT","脚本",6386,"https:\u002F\u002Fgithub.com\u002Fviktomas\u002Fdotfiles\u002Fblob\u002Fmaster\u002Fagents\u002F.agents\u002Fskills\u002Freview\u002Fscripts\u002Fget-mr-context.sh",{"path":75,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":76,"sourceHtmlUrl":77},"scripts\u002Fpost-comment.sh",3281,"https:\u002F\u002Fgithub.com\u002Fviktomas\u002Fdotfiles\u002Fblob\u002Fmaster\u002Fagents\u002F.agents\u002Fskills\u002Freview\u002Fscripts\u002Fpost-comment.sh",[79],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":95,"publishedAt":30},"01M6AD2P7TGXQ94WETVKTMQ8WX","release-major-version","Prepare the Apache Fory site for a release that opens a new documentation line, such as 0.17.0 or 1.6.0: write the release blog, update the download page, checkpoint with git commits, translate the zh-CN release blog and docs, create the versioned docs snapshot, update the default docs version, and run an independent self-review to catch remaining issues. Use only when the release requires a new Docusaurus versioned-docs snapshot. Do not use for patch releases such as 1.6.1 that update an existing documentation line.","https:\u002F\u002Fgithub.com\u002Fapache\u002Ffory-site\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Frelease-major-version\u002FSKILL.md",[85,90],{"categoryNo":86,"categoryName":87,"taxonomyType":88,"taxonomyTypeDesc":89},"01JBSEEDCAT000000000000018","写作与文案","SCENARIO","使用场景",{"categoryNo":91,"categoryName":92,"taxonomyType":93,"taxonomyTypeDesc":94},"01JBSEEDCAT000000000000036","内容创作者","PROFESSION","适用职业",[96,97,98,19,20,99,100,101,102,26,103,104,9],"release","release major version","review","prepare","documentation","create","run","git","issues"]