oh-my-agent-commandcode 0.0.0-stage → 20.38.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +35 -2
- package/filter-test-output.sh +52 -0
- package/mods/oma.ts +347 -0
- package/package.json +30 -4
- package/skills/_shared/conditional/experiment-ledger.md +28 -0
- package/skills/_shared/conditional/exploration-loop.md +22 -0
- package/skills/_shared/conditional/quality-score.md +33 -0
- package/skills/_shared/core/anti-ai-prose.md +191 -0
- package/skills/_shared/core/api-contracts/README.md +28 -0
- package/skills/_shared/core/api-contracts/template.md +90 -0
- package/skills/_shared/core/clarification-protocol.md +23 -0
- package/skills/_shared/core/code-intelligence.md +46 -0
- package/skills/_shared/core/collaboration-policy.md +28 -0
- package/skills/_shared/core/common-checklist.md +28 -0
- package/skills/_shared/core/context-budget.md +22 -0
- package/skills/_shared/core/context-loading.md +34 -0
- package/skills/_shared/core/difficulty-guide.md +26 -0
- package/skills/_shared/core/execution-policy.md +31 -0
- package/skills/_shared/core/lessons-learned.md +33 -0
- package/skills/_shared/core/prompt-structure.md +18 -0
- package/skills/_shared/core/quality-principles.md +11 -0
- package/skills/_shared/core/session-metrics.md +35 -0
- package/skills/_shared/core/skill-routing.md +39 -0
- package/skills/_shared/core/test-approach.md +54 -0
- package/skills/_shared/core/vendor-detection.md +52 -0
- package/skills/_shared/runtime/memory-protocol.md +118 -0
- package/skills/_shared/runtime/result-contract.md +64 -0
- package/skills/_shared/ui-interaction-quality.md +133 -0
- package/skills/oma-academic-writing/SKILL.md +181 -0
- package/skills/oma-academic-writing/resources/abstract-guide.md +51 -0
- package/skills/oma-academic-writing/resources/academic-verb-tiers.md +42 -0
- package/skills/oma-academic-writing/resources/anti-ai-checklist.md +52 -0
- package/skills/oma-academic-writing/resources/hedging-guide.md +132 -0
- package/skills/oma-academic-writing/resources/sentence-structure-reference.md +151 -0
- package/skills/oma-architecture/SKILL.md +203 -0
- package/skills/oma-architecture/resources/api-evolution.md +41 -0
- package/skills/oma-architecture/resources/checklist.md +42 -0
- package/skills/oma-architecture/resources/execution-protocol.md +115 -0
- package/skills/oma-architecture/resources/methodology-selection.md +92 -0
- package/skills/oma-architecture/resources/migration-patterns.md +28 -0
- package/skills/oma-architecture/resources/output-templates.md +111 -0
- package/skills/oma-architecture/resources/stakeholder-synthesis.md +80 -0
- package/skills/oma-backend/SKILL.md +202 -0
- package/skills/oma-backend/resources/checklist.md +45 -0
- package/skills/oma-backend/resources/error-playbook.md +97 -0
- package/skills/oma-backend/resources/execution-protocol.md +39 -0
- package/skills/oma-backend/resources/orm-reference.md +61 -0
- package/skills/oma-backend/variants/node/api-template.ts +315 -0
- package/skills/oma-backend/variants/node/snippets.md +475 -0
- package/skills/oma-backend/variants/node/stack.yaml +21 -0
- package/skills/oma-backend/variants/node/tech-stack.md +33 -0
- package/skills/oma-backend/variants/python/api-template.py +378 -0
- package/skills/oma-backend/variants/python/snippets.md +199 -0
- package/skills/oma-backend/variants/python/stack.yaml +18 -0
- package/skills/oma-backend/variants/python/tech-stack.md +45 -0
- package/skills/oma-backend/variants/rust/api-template.rs +635 -0
- package/skills/oma-backend/variants/rust/snippets.md +471 -0
- package/skills/oma-backend/variants/rust/stack.yaml +20 -0
- package/skills/oma-backend/variants/rust/tech-stack.md +36 -0
- package/skills/oma-backend/variants/stack.schema.json +73 -0
- package/skills/oma-brainstorm/SKILL.md +166 -0
- package/skills/oma-brainstorm/resources/triz-lite.md +117 -0
- package/skills/oma-coordination/SKILL.md +171 -0
- package/skills/oma-db/SKILL.md +201 -0
- package/skills/oma-db/resources/anti-patterns.md +177 -0
- package/skills/oma-db/resources/checklist.md +67 -0
- package/skills/oma-db/resources/document-templates.md +107 -0
- package/skills/oma-db/resources/error-playbook.md +50 -0
- package/skills/oma-db/resources/examples.md +170 -0
- package/skills/oma-db/resources/execution-protocol.md +127 -0
- package/skills/oma-db/resources/iso-controls.md +98 -0
- package/skills/oma-db/resources/migration-playbook.md +93 -0
- package/skills/oma-db/resources/query-tuning.md +57 -0
- package/skills/oma-db/resources/vector-db.md +159 -0
- package/skills/oma-debug/SKILL.md +146 -0
- package/skills/oma-debug/resources/bug-report-template.md +327 -0
- package/skills/oma-debug/resources/checklist.md +31 -0
- package/skills/oma-debug/resources/common-patterns.md +734 -0
- package/skills/oma-debug/resources/debugging-checklist.md +364 -0
- package/skills/oma-debug/resources/error-playbook.md +94 -0
- package/skills/oma-debug/resources/execution-protocol.md +40 -0
- package/skills/oma-design/SKILL.md +135 -0
- package/skills/oma-design/resources/asset-strategy.md +34 -0
- package/skills/oma-design/resources/checklist.md +63 -0
- package/skills/oma-design/resources/data-grid.md +48 -0
- package/skills/oma-design/resources/design-md-spec.md +107 -0
- package/skills/oma-design/resources/design-tokens.md +53 -0
- package/skills/oma-design/resources/error-playbook.md +18 -0
- package/skills/oma-design/resources/execution-protocol.md +95 -0
- package/skills/oma-design/resources/external-design-skills.md +130 -0
- package/skills/oma-design/resources/getdesign-fetcher.md +104 -0
- package/skills/oma-design/resources/product-interface-review.md +59 -0
- package/skills/oma-design/resources/redesign-protocol.md +52 -0
- package/skills/oma-design/resources/stitch-integration.md +244 -0
- package/skills/oma-dev-workflow/SKILL.md +375 -0
- package/skills/oma-dev-workflow/resources/affected-checks.py +58 -0
- package/skills/oma-dev-workflow/resources/api-workflows.md +58 -0
- package/skills/oma-dev-workflow/resources/database-patterns.md +107 -0
- package/skills/oma-dev-workflow/resources/i18n-patterns.md +63 -0
- package/skills/oma-dev-workflow/resources/release-coordination.md +240 -0
- package/skills/oma-dev-workflow/resources/tooling-profiles.md +217 -0
- package/skills/oma-dev-workflow/resources/troubleshooting.md +78 -0
- package/skills/oma-dev-workflow/resources/validation-pipeline.md +246 -0
- package/skills/oma-docs/SKILL.md +77 -0
- package/skills/oma-docs/resources/commands.md +76 -0
- package/skills/oma-explanation/SKILL.md +212 -0
- package/skills/oma-explanation/resources/document-structure.md +115 -0
- package/skills/oma-explanation/resources/draft-format.md +199 -0
- package/skills/oma-explanation/resources/html-contract.md +102 -0
- package/skills/oma-frontend/SKILL.md +227 -0
- package/skills/oma-frontend/resources/angular-rules.md +110 -0
- package/skills/oma-frontend/resources/checklist.md +76 -0
- package/skills/oma-frontend/resources/error-playbook.md +125 -0
- package/skills/oma-frontend/resources/execution-protocol.md +46 -0
- package/skills/oma-frontend/resources/snippets.md +354 -0
- package/skills/oma-frontend/resources/specialized-visual-implementation.md +193 -0
- package/skills/oma-frontend/resources/tailwind-rules.md +83 -0
- package/skills/oma-frontend/resources/tech-stack.md +156 -0
- package/skills/oma-hwp/SKILL.md +166 -0
- package/skills/oma-hwp/config/hwp-config.yaml +35 -0
- package/skills/oma-hwp/resources/balanced-tables.ts +39 -0
- package/skills/oma-hwp/resources/execution-protocol.md +145 -0
- package/skills/oma-hwp/resources/flatten-tables.ts +101 -0
- package/skills/oma-hwp/resources/package.json +13 -0
- package/skills/oma-hwp/resources/troubleshooting.md +70 -0
- package/skills/oma-hwp/resources/tsconfig.json +10 -0
- package/skills/oma-hwp/resources/turndown-plugin-gfm.d.ts +9 -0
- package/skills/oma-image/SKILL.md +142 -0
- package/skills/oma-image/config/image-config.yaml +70 -0
- package/skills/oma-image/resources/checklist.md +18 -0
- package/skills/oma-image/resources/execution-protocol.md +117 -0
- package/skills/oma-image/resources/invocation.md +105 -0
- package/skills/oma-image/resources/prompt-tips.md +71 -0
- package/skills/oma-image/resources/vendor-matrix.md +90 -0
- package/skills/oma-market/SKILL.md +142 -0
- package/skills/oma-market/resources/checklist.md +12 -0
- package/skills/oma-market/resources/error-playbook.md +12 -0
- package/skills/oma-market/resources/execution-protocol.md +60 -0
- package/skills/oma-market/resources/frameworks/pestel.md +101 -0
- package/skills/oma-market/resources/frameworks/porters-5f.md +90 -0
- package/skills/oma-market/resources/frameworks/swot.md +61 -0
- package/skills/oma-market/resources/intent-rules.md +35 -0
- package/skills/oma-market/resources/output-laws.md +53 -0
- package/skills/oma-mobile/SKILL.md +168 -0
- package/skills/oma-mobile/resources/checklist.md +77 -0
- package/skills/oma-mobile/resources/error-playbook.md +198 -0
- package/skills/oma-mobile/resources/execution-protocol.md +47 -0
- package/skills/oma-mobile/resources/screen-template.dart +331 -0
- package/skills/oma-mobile/resources/screen-template.swift +239 -0
- package/skills/oma-mobile/resources/screen-template.tsx +179 -0
- package/skills/oma-mobile/resources/tech-stack.md +69 -0
- package/skills/oma-mobile/variants/README.md +45 -0
- package/skills/oma-mobile/variants/flutter/api-template.dart +461 -0
- package/skills/oma-mobile/variants/flutter/snippets.md +1353 -0
- package/skills/oma-mobile/variants/flutter/stack.yaml +21 -0
- package/skills/oma-mobile/variants/flutter/tech-stack.md +201 -0
- package/skills/oma-mobile/variants/kotlin-android/api-template.kt +182 -0
- package/skills/oma-mobile/variants/kotlin-android/snippets.md +871 -0
- package/skills/oma-mobile/variants/kotlin-android/stack.yaml +32 -0
- package/skills/oma-mobile/variants/kotlin-android/tech-stack.md +159 -0
- package/skills/oma-mobile/variants/react-native/api-template.ts +531 -0
- package/skills/oma-mobile/variants/react-native/snippets.md +1014 -0
- package/skills/oma-mobile/variants/react-native/stack.yaml +22 -0
- package/skills/oma-mobile/variants/react-native/tech-stack.md +192 -0
- package/skills/oma-mobile/variants/stack.schema.json +68 -0
- package/skills/oma-mobile/variants/swift-ios/api-template.swift +165 -0
- package/skills/oma-mobile/variants/swift-ios/snippets.md +1028 -0
- package/skills/oma-mobile/variants/swift-ios/stack.yaml +25 -0
- package/skills/oma-mobile/variants/swift-ios/tech-stack.md +174 -0
- package/skills/oma-observability/SKILL.md +225 -0
- package/skills/oma-observability/resources/anti-patterns.md +555 -0
- package/skills/oma-observability/resources/boundaries/cross-application.md +348 -0
- package/skills/oma-observability/resources/boundaries/multi-tenant.md +290 -0
- package/skills/oma-observability/resources/boundaries/release.md +372 -0
- package/skills/oma-observability/resources/boundaries/slo.md +225 -0
- package/skills/oma-observability/resources/checklist.md +123 -0
- package/skills/oma-observability/resources/examples.md +448 -0
- package/skills/oma-observability/resources/execution-protocol.md +166 -0
- package/skills/oma-observability/resources/incident-forensics.md +348 -0
- package/skills/oma-observability/resources/intent-rules.md +307 -0
- package/skills/oma-observability/resources/layers/L3-network.md +281 -0
- package/skills/oma-observability/resources/layers/L4-transport.md +299 -0
- package/skills/oma-observability/resources/layers/L7-application/crash-analytics.md +359 -0
- package/skills/oma-observability/resources/layers/L7-application/mobile-rum.md +278 -0
- package/skills/oma-observability/resources/layers/L7-application/waf.md +246 -0
- package/skills/oma-observability/resources/layers/L7-application/web-rum.md +350 -0
- package/skills/oma-observability/resources/layers/mesh.md +368 -0
- package/skills/oma-observability/resources/matrix.md +177 -0
- package/skills/oma-observability/resources/meta-observability.md +605 -0
- package/skills/oma-observability/resources/observability-as-code.md +666 -0
- package/skills/oma-observability/resources/signals/audit.md +310 -0
- package/skills/oma-observability/resources/signals/cost.md +303 -0
- package/skills/oma-observability/resources/signals/logs.md +263 -0
- package/skills/oma-observability/resources/signals/metrics.md +478 -0
- package/skills/oma-observability/resources/signals/privacy.md +351 -0
- package/skills/oma-observability/resources/signals/profiles.md +245 -0
- package/skills/oma-observability/resources/signals/traces.md +360 -0
- package/skills/oma-observability/resources/standards.md +214 -0
- package/skills/oma-observability/resources/transport/collector-topology.md +308 -0
- package/skills/oma-observability/resources/transport/otlp-grpc-vs-http.md +256 -0
- package/skills/oma-observability/resources/transport/sampling-recipes.md +297 -0
- package/skills/oma-observability/resources/transport/udp-statsd-mtu.md +167 -0
- package/skills/oma-observability/resources/vendor-categories.md +352 -0
- package/skills/oma-orchestration/SKILL.md +302 -0
- package/skills/oma-orchestration/config/cli-config.yaml +92 -0
- package/skills/oma-orchestration/resources/memory-schema.md +232 -0
- package/skills/oma-orchestration/resources/subagent-prompt-template.md +30 -0
- package/skills/oma-orchestration/scripts/parallel-run.sh +6 -0
- package/skills/oma-orchestration/scripts/spawn-agent.sh +5 -0
- package/skills/oma-orchestration/scripts/verify.sh +20 -0
- package/skills/oma-orchestration/templates/backend-task.md +19 -0
- package/skills/oma-orchestration/templates/debug-task.md +16 -0
- package/skills/oma-orchestration/templates/frontend-task.md +18 -0
- package/skills/oma-orchestration/templates/mobile-task.md +18 -0
- package/skills/oma-orchestration/templates/qa-task.md +16 -0
- package/skills/oma-orchestration/templates/tasks-example.yaml +15 -0
- package/skills/oma-pdf/SKILL.md +162 -0
- package/skills/oma-pdf/config/pdf-config.yaml +27 -0
- package/skills/oma-pdf/resources/execution-protocol.md +127 -0
- package/skills/oma-pm/SKILL.md +157 -0
- package/skills/oma-pm/resources/error-playbook.md +75 -0
- package/skills/oma-pm/resources/examples.md +439 -0
- package/skills/oma-pm/resources/execution-protocol.md +62 -0
- package/skills/oma-pm/resources/iso-planning.md +110 -0
- package/skills/oma-pm/resources/plan-phase-protocol.md +66 -0
- package/skills/oma-pm/resources/task-template.json +86 -0
- package/skills/oma-qa/SKILL.md +141 -0
- package/skills/oma-qa/resources/checklist.md +339 -0
- package/skills/oma-qa/resources/error-playbook.md +98 -0
- package/skills/oma-qa/resources/execution-protocol.md +169 -0
- package/skills/oma-qa/resources/iso-quality.md +82 -0
- package/skills/oma-qa/resources/verify-ship-protocol.md +116 -0
- package/skills/oma-recap/SKILL.md +245 -0
- package/skills/oma-recap/resources/output-formats.md +83 -0
- package/skills/oma-refactor/SKILL.md +184 -0
- package/skills/oma-refactor/resources/definition.md +108 -0
- package/skills/oma-refactor/resources/governance.md +33 -0
- package/skills/oma-refactor/resources/hotspots.py +44 -0
- package/skills/oma-refactor/resources/measurement.md +93 -0
- package/skills/oma-scholar/SKILL.md +276 -0
- package/skills/oma-scholar/config/scholar-config.yaml +79 -0
- package/skills/oma-scholar/resources/api-endpoints.md +174 -0
- package/skills/oma-scholar/resources/checklist.md +92 -0
- package/skills/oma-scholar/resources/execution-protocol.md +224 -0
- package/skills/oma-scholar/resources/fallback-providers.md +143 -0
- package/skills/oma-scholar/resources/setup-openalex.md +85 -0
- package/skills/oma-scholar/resources/sidecar-spec.md +341 -0
- package/skills/oma-scholar/resources/upstream-spec-cache.md +972 -0
- package/skills/oma-scm/SKILL.md +103 -0
- package/skills/oma-scm/resources/cm-operations.md +56 -0
- package/skills/oma-scm/resources/codeowners-playbook.md +45 -0
- package/skills/oma-scm/resources/conventional-commits.md +108 -0
- package/skills/oma-scm/resources/merge-risk.md +76 -0
- package/skills/oma-scm/resources/onboarding-risk-signals.md +71 -0
- package/skills/oma-search/SKILL.md +125 -0
- package/skills/oma-search/resources/checklist.md +36 -0
- package/skills/oma-search/resources/error-playbook.md +66 -0
- package/skills/oma-search/resources/examples.md +80 -0
- package/skills/oma-search/resources/execution-protocol.md +86 -0
- package/skills/oma-search/resources/intent-rules.md +47 -0
- package/skills/oma-search/resources/trust-registry.md +53 -0
- package/skills/oma-security/SKILL.md +172 -0
- package/skills/oma-security/resources/artex.md +108 -0
- package/skills/oma-security/resources/ci.md +134 -0
- package/skills/oma-security/resources/cisco-source.md +108 -0
- package/skills/oma-security/resources/deepsec-config.md +45 -0
- package/skills/oma-security/resources/deepsec-matchers.md +35 -0
- package/skills/oma-security/resources/deepsec-scanning.md +45 -0
- package/skills/oma-security/resources/deepsec-setup.md +41 -0
- package/skills/oma-security/resources/findings-contract.md +408 -0
- package/skills/oma-security/resources/mcp-scanning.md +122 -0
- package/skills/oma-security/resources/skill-scanning.md +106 -0
- package/skills/oma-security/resources/validation.md +71 -0
- package/skills/oma-skill-creation/SKILL.md +84 -0
- package/skills/oma-skill-creation/resources/prompt-evaluation.md +36 -0
- package/skills/oma-skill-creation/resources/ssl-lite-template.md +108 -0
- package/skills/oma-skill-creation/resources/validation-checklist.md +101 -0
- package/skills/oma-slide/SKILL.md +277 -0
- package/skills/oma-slide/resources/animation-patterns.md +245 -0
- package/skills/oma-slide/resources/assets/deck-stage.js +514 -0
- package/skills/oma-slide/resources/assets/viewport-base.css +257 -0
- package/skills/oma-slide/resources/canva-integration.md +203 -0
- package/skills/oma-slide/resources/checklist.md +46 -0
- package/skills/oma-slide/resources/design-doctrine.md +260 -0
- package/skills/oma-slide/resources/fixed-stage.md +232 -0
- package/skills/oma-slide/resources/generation-protocol.md +393 -0
- package/skills/oma-slide/resources/native-pptx.md +84 -0
- package/skills/oma-slide/resources/selection-index.json +461 -0
- package/skills/oma-slide/resources/style-presets.LICENSE +10 -0
- package/skills/oma-slide/resources/style-presets.md +520 -0
- package/skills/oma-tf-infra/SKILL.md +201 -0
- package/skills/oma-tf-infra/resources/checklist.md +53 -0
- package/skills/oma-tf-infra/resources/cost-optimization.md +574 -0
- package/skills/oma-tf-infra/resources/error-playbook.md +68 -0
- package/skills/oma-tf-infra/resources/examples.md +38 -0
- package/skills/oma-tf-infra/resources/execution-protocol.md +129 -0
- package/skills/oma-tf-infra/resources/iso-42001-infra.md +229 -0
- package/skills/oma-tf-infra/resources/multi-cloud-examples.md +241 -0
- package/skills/oma-tf-infra/resources/policy-testing-examples.md +332 -0
- package/skills/oma-translation/SKILL.md +229 -0
- package/skills/oma-translation/resources/anti-ai-patterns.md +104 -0
- package/skills/oma-translation/resources/lang/_template.md +73 -0
- package/skills/oma-translation/resources/lang/en.md +123 -0
- package/skills/oma-translation/resources/lang/ja.md +274 -0
- package/skills/oma-translation/resources/lang/ko.md +228 -0
- package/skills/oma-translation/resources/lang/zh.md +285 -0
- package/skills/oma-translation/resources/style-skills.md +104 -0
- package/skills/oma-translation/resources/translation-rubric.md +126 -0
- package/skills/oma-video/SKILL.md +229 -0
- package/skills/oma-video/config/video-config.yaml +60 -0
- package/skills/oma-video/resources/checklist.md +26 -0
- package/skills/oma-video/resources/execution-protocol.md +122 -0
- package/skills/oma-video/resources/existing-media.md +185 -0
- package/skills/oma-video/resources/hyperframes-authoring/README.md +44 -0
- package/skills/oma-video/resources/hyperframes-authoring/demo.md +31 -0
- package/skills/oma-video/resources/hyperframes-authoring/explainer.md +10 -0
- package/skills/oma-video/resources/hyperframes-authoring/shorts.md +10 -0
- package/skills/oma-video/resources/motion-principles.md +81 -0
- package/skills/oma-video/resources/mpt/driver.py +301 -0
- package/skills/oma-video/resources/prompt-tips.md +75 -0
- package/skills/oma-video/resources/script-schema.md +81 -0
- package/skills/oma-video/resources/sound-design.md +127 -0
- package/skills/oma-video/resources/strudel/package.json +11 -0
- package/skills/oma-video/resources/strudel/page.html +87 -0
- package/skills/oma-video/resources/strudel/render.mjs +295 -0
- package/skills/oma-video/resources/vendor-matrix.md +124 -0
- package/skills/oma-voice/SKILL.md +249 -0
- package/skills/oma-voice/config/voice-config.yaml +30 -0
- package/skills/oma-voice/resources/audio-processing.md +119 -0
- package/skills/oma-voice/resources/checklist.md +47 -0
- package/skills/oma-voice/resources/execution-protocol.md +215 -0
- package/skills/oma-voice/resources/prompt-tips.md +43 -0
- package/skills/oma-voice/resources/voice-matrix.md +51 -0
- package/skills/oma-voice/resources/voicestudio.md +87 -0
|
@@ -0,0 +1,228 @@
|
|
|
1
|
+
# Korean Target-Language Profile (`ko`)
|
|
2
|
+
|
|
3
|
+
Load this profile when the **target** primary language subtag is `ko`, including
|
|
4
|
+
`ko-KR`. Read it with `../translation-rubric.md` for substantive content or
|
|
5
|
+
review. For substantive prose style, follow `../style-skills.md`.
|
|
6
|
+
|
|
7
|
+
This profile owns Korean grammar, register, and project conventions.
|
|
8
|
+
|
|
9
|
+
All examples are illustrative pairs in `bad → good` form. Do not translate the
|
|
10
|
+
rule text itself into the output.
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## Register
|
|
15
|
+
|
|
16
|
+
Korean forces a sentence-ending choice on every sentence. Pick once per
|
|
17
|
+
document and never drift.
|
|
18
|
+
|
|
19
|
+
| Style | Ending | Use for |
|
|
20
|
+
|---|---|---|
|
|
21
|
+
| 합니다체 | `-습니다` / `-ㅂ니다` | reports, user-facing docs, release notes, agent output |
|
|
22
|
+
| 해요체 | `-어요` / `-아요` | conversational UI, onboarding microcopy, casual product voice |
|
|
23
|
+
| 한다체 (평서체) | `-다` / `-이다` | reference docs, specs, academic prose, changelog bodies |
|
|
24
|
+
|
|
25
|
+
Resolution order:
|
|
26
|
+
|
|
27
|
+
1. Match the dominant ending of sibling files in the same directory.
|
|
28
|
+
2. If no siblings exist, map from `translation_voice` in `.agents/oma-config.yaml`:
|
|
29
|
+
`formal` → 합니다체, `balanced` → 합니다체 for prose and 한다체 for reference
|
|
30
|
+
tables, `interpreter` → 합니다체 with shorter sentences and permitted
|
|
31
|
+
label-position fragments.
|
|
32
|
+
3. If the source is dialogue or subtitle content, follow the speaker relationship
|
|
33
|
+
in the source rather than the file convention.
|
|
34
|
+
|
|
35
|
+
Never mix 합니다체 with 한다체 inside one document. Headings and table cells are
|
|
36
|
+
exempt because they carry no ending at all.
|
|
37
|
+
|
|
38
|
+
**Honorific target**: raise the listener (`-시-`, `-께서`, 공손 어휘) only when the
|
|
39
|
+
source addresses a person directly or the project already does so. Do not add
|
|
40
|
+
`사용자님`-class honorifics to documentation that addresses a generic reader.
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## Korean-only rules
|
|
45
|
+
|
|
46
|
+
### KO-1. Do not drop particles or endings
|
|
47
|
+
|
|
48
|
+
Compressed agent Korean drops 조사 and 어미 to save tokens, which strips out the
|
|
49
|
+
grammatical relations that carry the meaning. Restore them. Use 부사, 보조사,
|
|
50
|
+
선어말어미, and 보조 용언 actively rather than treating them as optional padding.
|
|
51
|
+
|
|
52
|
+
```
|
|
53
|
+
이 결정은 이후 중요 정책이 갈리는 자리. 컨텍스트 압축 전 신중 반영한다.
|
|
54
|
+
→ 이 결정은 이후 중요한 정책에 지속적으로 영향을 주기 때문에, 컨텍스트가
|
|
55
|
+
압축되기 전에 신중히 반영합니다.
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
This is a restoration of grammar, not an addition of meaning. It must not
|
|
59
|
+
introduce facts, opinions, or emphasis that the source does not carry.
|
|
60
|
+
|
|
61
|
+
### KO-2. Genitive `의` chains hide dropped sentence elements
|
|
62
|
+
|
|
63
|
+
`의` linking two or more nouns is a diagnostic signal, not merely a style
|
|
64
|
+
preference: the predicate and the particles that belong in that position have
|
|
65
|
+
been deleted. Two `의` in one noun phrase is a hard flag; three is a block.
|
|
66
|
+
|
|
67
|
+
```
|
|
68
|
+
사본의 문구는 작업의 상황을
|
|
69
|
+
→ 사본에 기재된 문구는 작업이 진행되는 상황을
|
|
70
|
+
|
|
71
|
+
지출 비용 추론 용도의 토큰 카운트 함수의 오류 상황에서
|
|
72
|
+
→ 지출한 비용을 추론하는 토큰 카운트 함수에 오류가 발생하면
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
Also delete `의` that entered as a calque of Japanese `の` or English `of` where
|
|
76
|
+
Korean would use no particle at all: `최대의 성능` → `최대 성능`,
|
|
77
|
+
`두 개의 파일` → `파일 두 개`.
|
|
78
|
+
|
|
79
|
+
A genitive chain can hide a dropped predicate even when it has fewer than three
|
|
80
|
+
modifiers.
|
|
81
|
+
|
|
82
|
+
### KO-3. Finish the sentence
|
|
83
|
+
|
|
84
|
+
End body sentences with a predicate and a final ending. Three failure shapes:
|
|
85
|
+
|
|
86
|
+
| Shape | Bad | Good |
|
|
87
|
+
|---|---|---|
|
|
88
|
+
| Noun ending | `lint 실패.` | `lint가 실패했습니다.` |
|
|
89
|
+
| Adverbial ending | `설정 파일을 읽지 못한 채로.` | `설정 파일을 읽지 못한 채로 종료했습니다.` |
|
|
90
|
+
| Connective ending | `캐시를 비우고 다시 실행했으며,` | `캐시를 비우고 다시 실행했습니다.` |
|
|
91
|
+
|
|
92
|
+
Exempt positions: headings, list items that act as labels, table cells, and
|
|
93
|
+
`key: value` pairs. `결과: lint 실패` is correct; a bare `lint 실패.` sitting in a
|
|
94
|
+
paragraph is not.
|
|
95
|
+
|
|
96
|
+
**Trailing negation calque**: English tacks short negation fragments onto a
|
|
97
|
+
sentence end (`..., no guessing`). Calquing this produces `..., 추측 없이`, which
|
|
98
|
+
is a noun fragment in Korean body text.
|
|
99
|
+
|
|
100
|
+
```
|
|
101
|
+
선택된 항목에서 옵션이 나옵니다, 추측 없이.
|
|
102
|
+
→ 선택된 항목에서 바로 옵션을 가져오므로 사용자가 추측할 필요가 없습니다.
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
### KO-4. Sino-Korean vocabulary is not the problem; bare Sino-Korean nouns are
|
|
106
|
+
|
|
107
|
+
Keep precise Sino-Korean terms and supply the particles and inflections they
|
|
108
|
+
need. A bare Sino-Korean noun with no particle or verb ending can hide the action.
|
|
109
|
+
|
|
110
|
+
```
|
|
111
|
+
지출 비용 추론 용도의 토큰 카운트 함수의 오류 상황에서 (no particles, relations unclear)
|
|
112
|
+
쓴 비용을 구하는 토큰 카운트 함수에 문제가 생기면 (over-nativized, imprecise)
|
|
113
|
+
→ 지출한 비용을 추론하는 토큰 카운트 함수에 오류가 발생하면
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
`발생하면`, `추론하는`, `지출한` are all Sino-Korean and all correct, because each
|
|
117
|
+
carries an ending.
|
|
118
|
+
|
|
119
|
+
### KO-5. No noun-pinned verbs
|
|
120
|
+
|
|
121
|
+
Pinning a verb into Korean as a bare noun, whether an English loanword or a
|
|
122
|
+
stiff Sino-Korean noun, reads as jargon.
|
|
123
|
+
|
|
124
|
+
```
|
|
125
|
+
skill을 로드 → skill을 불러옵니다
|
|
126
|
+
프로젝트에 시드 → 프로젝트에 심습니다
|
|
127
|
+
`<HARD-GATE>` 발동 → `<HARD-GATE>`가 걸렸습니다
|
|
128
|
+
마이그레이션 진행 → 마이그레이션을 실행했습니다
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
### KO-6. No figurative substitution for plain vocabulary
|
|
132
|
+
|
|
133
|
+
Do not introduce figurative Korean vocabulary when the source uses a plain noun
|
|
134
|
+
or verb. It changes the meaning.
|
|
135
|
+
|
|
136
|
+
```
|
|
137
|
+
분석의 플로우 → 분석의 흐름
|
|
138
|
+
코드로 박는 자리 → 코드에 명시하는 위치
|
|
139
|
+
요청을 수신합니다 → 요청을 받습니다
|
|
140
|
+
테스트를 태웁니다 → 테스트를 실행합니다
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
Keep expressions that are already established idiom in the field and would sound
|
|
144
|
+
stilted if flattened (`병목`, `롤백`, `핫픽스`).
|
|
145
|
+
|
|
146
|
+
### KO-8. Korean translation-ese constructions
|
|
147
|
+
|
|
148
|
+
| Pattern | Bad | Good |
|
|
149
|
+
|---|---|---|
|
|
150
|
+
| 이중 피동 | `보여집니다`, `불려집니다`, `되어집니다` | `보입니다`, `불립니다`, `됩니다` |
|
|
151
|
+
| `~에 대한` overuse | `설정에 대한 검토를 했습니다` | `설정을 검토했습니다` |
|
|
152
|
+
| `~에 있어서` (JA `における`) | `배포에 있어서 중요한 것은` | `배포에서 중요한 점은` |
|
|
153
|
+
| `~로부터` (JA `から`) | `서버로부터 응답을 받았습니다` | `서버에서 응답을 받았습니다` |
|
|
154
|
+
| `~에 의해` (EN passive) | `팀에 의해 개발되었습니다` | `팀이 개발했습니다` |
|
|
155
|
+
| `~적(的)` stacking | `구조적, 기능적 개선` | `구조와 기능을 개선` |
|
|
156
|
+
| `~들` plural forcing | `파일들을 모두 삭제했습니다` | `파일을 모두 삭제했습니다` |
|
|
157
|
+
| `~하는 것이 가능하다` | `재시도하는 것이 가능합니다` | `재시도할 수 있습니다` |
|
|
158
|
+
| `~화(化)` nominalizing | `자동화를 진행합니다` | `자동으로 처리합니다` |
|
|
159
|
+
|
|
160
|
+
Korean marks plurality with quantifiers and context. Use `들` only when the
|
|
161
|
+
plural reading would otherwise be lost.
|
|
162
|
+
|
|
163
|
+
### KO-9. Typography and spacing
|
|
164
|
+
|
|
165
|
+
- **Inline code + particle**: no space between a backtick span and the particle
|
|
166
|
+
that follows. `` `prompt` 로 `` → `` `prompt`로 ``.
|
|
167
|
+
- **Counters**: no space between numeral and counter. `5 개` → `5개`, `3 번째` →
|
|
168
|
+
`3번째`. Units keep a space: `10 MB`, `200 ms`.
|
|
169
|
+
- **Em dash**: reconstruct the clause in Korean body prose rather than replacing
|
|
170
|
+
the dash with another punctuation mark.
|
|
171
|
+
- **Quotes**: straight `"` and `'`, or `「」` only when the project already uses
|
|
172
|
+
them. Do not emit curly quotes.
|
|
173
|
+
- **Parentheses**: halfwidth `()` with no leading space when attached to a term:
|
|
174
|
+
`하네스(harness)`.
|
|
175
|
+
- **Ellipsis**: `...` rather than `…` unless the source file already uses `…`.
|
|
176
|
+
- **Middle dot**: `·` for tight coordination in headings (`설치·설정`), commas in
|
|
177
|
+
body text.
|
|
178
|
+
|
|
179
|
+
### KO-10. Loanword orthography (외래어 표기법)
|
|
180
|
+
|
|
181
|
+
Use the standard form. Frequent misspellings in machine output:
|
|
182
|
+
|
|
183
|
+
```
|
|
184
|
+
컨텐츠 → 콘텐츠 메세지 → 메시지 데이타 → 데이터
|
|
185
|
+
윈도우즈 → 윈도우 타겟 → 타깃 레퍼런스 → 레퍼런스 (ok)
|
|
186
|
+
쉐이더 → 셰이더 플래폼 → 플랫폼 비지니스 → 비즈니스
|
|
187
|
+
어플리케이션 → 애플리케이션 스케쥴 → 스케줄
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
When the project's existing translations consistently use a non-standard form,
|
|
191
|
+
follow the project and note the conflict once.
|
|
192
|
+
|
|
193
|
+
### KO-11. Numbers, dates, units
|
|
194
|
+
|
|
195
|
+
- Dates: `2026년 8월 20일` in prose, `2026-08-20` in tables and logs.
|
|
196
|
+
- Ranges: `3~5개` in prose, `3-5` inside code or config values.
|
|
197
|
+
- Large numbers: comma grouping (`12,000`), and `만`/`억` only when the source
|
|
198
|
+
uses a comparable scale word.
|
|
199
|
+
- Percent: `40%` with no space.
|
|
200
|
+
|
|
201
|
+
### KO-12. Subagent and multi-hop Korean
|
|
202
|
+
|
|
203
|
+
When Korean text will be consumed by another agent rather than by a person
|
|
204
|
+
(subagent prompts, intermediate result files, handoff summaries), apply `KO-1`
|
|
205
|
+
through `KO-3` before handing it off. Quality loss compounds at every hop in
|
|
206
|
+
`orchestrate`, `ultrawork`, and `ralph`, and a dropped particle in a stage-1
|
|
207
|
+
prompt becomes a wrong decision in stage 3.
|
|
208
|
+
|
|
209
|
+
Internal status keywords, workflow markers, and log levels stay in English per
|
|
210
|
+
`.agents/rules/i18n-guide.md`.
|
|
211
|
+
|
|
212
|
+
---
|
|
213
|
+
|
|
214
|
+
## Korean self-check
|
|
215
|
+
|
|
216
|
+
Check source-to-Korean grammar and project conventions before delivery.
|
|
217
|
+
|
|
218
|
+
- [ ] One sentence-ending style throughout; no 합니다체 / 한다체 mixing
|
|
219
|
+
- [ ] No dropped 조사 or 어미 in body text (`KO-1`)
|
|
220
|
+
- [ ] No noun phrase with two or more chained `의` (`KO-2`)
|
|
221
|
+
- [ ] No body sentence ending in a noun, adverbial, or connective (`KO-3`)
|
|
222
|
+
- [ ] No bare Sino-Korean or loanword noun standing in for a verb (`KO-4`, `KO-5`)
|
|
223
|
+
- [ ] No invented figurative vocabulary where the source was plain (`KO-6`)
|
|
224
|
+
- [ ] No 이중 피동, `~에 대한`, `~에 있어서`, `~들` forcing (`KO-8`)
|
|
225
|
+
- [ ] No space between inline code and its particle; no space in `5개` (`KO-9`)
|
|
226
|
+
- [ ] No `—`, no curly quotes (`KO-9`)
|
|
227
|
+
- [ ] Loanwords follow 외래어 표기법 or the project's established forms (`KO-10`)
|
|
228
|
+
- [ ] Korean handed to another agent passes `KO-1`–`KO-3` (`KO-12`)
|
|
@@ -0,0 +1,285 @@
|
|
|
1
|
+
# Chinese Target-Language Profile (`zh`)
|
|
2
|
+
|
|
3
|
+
Load this file whenever the **target** language is Chinese. It is read together
|
|
4
|
+
with `../translation-rubric.md` for substantive content or review. For prose style
|
|
5
|
+
review, also load `../../../_shared/core/anti-ai-prose.md` (common taxonomy) and
|
|
6
|
+
`../anti-ai-patterns.md` (translation exceptions and grammar diagnostics).
|
|
7
|
+
|
|
8
|
+
- **Localizations** of shared anti-AI patterns.
|
|
9
|
+
- **Chinese-only rules** (`ZH-1`–`ZH-9`).
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## Variant resolution (do this first)
|
|
14
|
+
|
|
15
|
+
`zh` is not a single target. Resolve the variant before translating a single
|
|
16
|
+
string, because script, vocabulary, and punctuation all diverge.
|
|
17
|
+
|
|
18
|
+
| Locale | Script | Region vocabulary |
|
|
19
|
+
|---|---|---|
|
|
20
|
+
| `zh-CN` / `zh-Hans` | 简体 | 软件, 网络, 程序, 服务器, 内存, 视频 |
|
|
21
|
+
| `zh-TW` / `zh-Hant-TW` | 繁體 | 軟體, 網路, 程式, 伺服器, 記憶體, 影片 |
|
|
22
|
+
| `zh-HK` / `zh-Hant-HK` | 繁體 | mostly TW vocabulary, HK-specific terms where established |
|
|
23
|
+
|
|
24
|
+
Resolution order: explicit locale in the file path or user request → dominant
|
|
25
|
+
script of sibling files → ask. If bare `zh` is requested with no signal, default
|
|
26
|
+
to `zh-CN` and say so once in the output notes. Never mix scripts in one file,
|
|
27
|
+
and never convert 简体 to 繁體 by character substitution alone: the vocabulary
|
|
28
|
+
must be converted too (`软件` → `軟體`, not `軟件`).
|
|
29
|
+
|
|
30
|
+
## Register
|
|
31
|
+
|
|
32
|
+
Chinese has no obligatory sentence-ending register system, so consistency lives
|
|
33
|
+
in vocabulary and sentence length instead.
|
|
34
|
+
|
|
35
|
+
| Voice | Effect |
|
|
36
|
+
|---|---|
|
|
37
|
+
| `formal` | 书面语, full sentences, 您 for the reader, no fragments |
|
|
38
|
+
| `balanced` | 书面语 in prose, fragments allowed in table cells and labels |
|
|
39
|
+
| `interpreter` | shorter clauses, 你 acceptable in product UI, spoken cadence |
|
|
40
|
+
|
|
41
|
+
Use `您` in enterprise and formal docs, `你` in developer-facing and product UI
|
|
42
|
+
when the project already does. Do not switch mid-document.
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
## Chinese-only rules
|
|
47
|
+
|
|
48
|
+
### ZH-1. `的` overuse (的的不休)
|
|
49
|
+
|
|
50
|
+
Chinese drops `的` far more readily than English drops `of`. Two `的` in one
|
|
51
|
+
noun phrase is a flag; three is a block.
|
|
52
|
+
|
|
53
|
+
```
|
|
54
|
+
Bad: 这是一个用于处理用户的请求的高性能的服务
|
|
55
|
+
Good: 这是处理用户请求的高性能服务
|
|
56
|
+
|
|
57
|
+
Bad: 系统的性能的提升
|
|
58
|
+
Good: 系统性能提升
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
Drop `的` between a monosyllabic modifier and its noun (`红花`, not `红的花`),
|
|
62
|
+
and after established compounds (`用户体验`, not `用户的体验`).
|
|
63
|
+
|
|
64
|
+
### ZH-2. `一个` as an indefinite article calque
|
|
65
|
+
|
|
66
|
+
English `a/an` has no Chinese equivalent. Insert a measure word only when the
|
|
67
|
+
count matters.
|
|
68
|
+
|
|
69
|
+
```
|
|
70
|
+
Bad: 这是一个强大的工具
|
|
71
|
+
Good: 这是强大的工具 / 这个工具很强大
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
### ZH-3. `们` plural forcing
|
|
75
|
+
|
|
76
|
+
Chinese marks plurality with context and quantifiers. `们` attaches only to
|
|
77
|
+
human nouns, and even then only when the plural reading would be lost.
|
|
78
|
+
|
|
79
|
+
```
|
|
80
|
+
Bad: 删除所有的文件们
|
|
81
|
+
Good: 删除所有文件
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### ZH-4. Empty verbs (`进行` / `做出` / `实施` / `予以`)
|
|
85
|
+
|
|
86
|
+
```
|
|
87
|
+
进行了讨论 → 讨论了
|
|
88
|
+
做出了改进 → 改进了
|
|
89
|
+
实施优化 → 优化
|
|
90
|
+
予以处理 → 处理
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
### ZH-5. `关于` / `对于` overuse
|
|
94
|
+
|
|
95
|
+
```
|
|
96
|
+
Bad: 关于配置的检查已经完成
|
|
97
|
+
Good: 配置检查已完成
|
|
98
|
+
|
|
99
|
+
Bad: 对于这个问题,我们进行了修复
|
|
100
|
+
Good: 我们修复了这个问题
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
### ZH-6. Long pre-nominal modifiers
|
|
104
|
+
|
|
105
|
+
Chinese places modifiers before the noun, so English relative clauses pile up
|
|
106
|
+
into unreadable strings. Split into separate clauses or use a 把 / 被 pivot.
|
|
107
|
+
|
|
108
|
+
```
|
|
109
|
+
Bad: 基于 AI 的支持云端部署的实时数据监控系统
|
|
110
|
+
Good: 一套用 AI 在云端做实时数据监控的系统
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
Rule: more than about 12 characters of pre-nominal modifier → restructure.
|
|
114
|
+
|
|
115
|
+
### ZH-7. Punctuation and spacing
|
|
116
|
+
|
|
117
|
+
- **Fullwidth punctuation**: `,` `。` `、` `:` `;` `?` `!`. Never halfwidth in
|
|
118
|
+
Chinese body text.
|
|
119
|
+
- **Enumeration comma**: `、` between list items inside a sentence, `,` between
|
|
120
|
+
clauses. These are not interchangeable.
|
|
121
|
+
- **Quotes**: `“”` and `‘’` for `zh-CN`, `「」` and `『』` for `zh-TW` / `zh-HK`.
|
|
122
|
+
This is the one target where curly quotes are correct; the shared curly-quote
|
|
123
|
+
check must not strip them.
|
|
124
|
+
- **Brackets**: fullwidth `()` around Chinese content, halfwidth `()` around
|
|
125
|
+
ASCII-only content.
|
|
126
|
+
- **Em dash**: Chinese uses `——` (double-width, two ems) for a genuine break,
|
|
127
|
+
which is not the same mark as `—`. Prefer restructuring; do not carry the
|
|
128
|
+
English `—` through.
|
|
129
|
+
- **Latin spacing**: follow the project convention for a space between Chinese
|
|
130
|
+
and ASCII runs. Read three sibling files before choosing; do not switch
|
|
131
|
+
mid-file.
|
|
132
|
+
- **Ellipsis**: `……` (six dots, two characters), not `...`.
|
|
133
|
+
|
|
134
|
+
### ZH-8. Abstract suffix overuse (`性` / `化` / `度`)
|
|
135
|
+
|
|
136
|
+
```
|
|
137
|
+
提高了系统的可用性和稳定性 → 系统更稳定、更少出问题
|
|
138
|
+
进行自动化处理 → 自动处理
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
Keep the suffix when it is established terminology (`可用性`, `幂等性`,
|
|
142
|
+
`向后兼容性`).
|
|
143
|
+
|
|
144
|
+
### ZH-9. Numbers, dates, units
|
|
145
|
+
|
|
146
|
+
- Dates: `2026年8月20日` in prose, `2026-08-20` in tables and logs.
|
|
147
|
+
- Numerals: halfwidth (`5 个`, `12,000`).
|
|
148
|
+
- Percent: `40%` with no space.
|
|
149
|
+
- Ranges: `3~5 个` or `3 到 5 个`; do not use `—`.
|
|
150
|
+
- Measure words must match the noun (`个`, `台`, `条`, `项`, `次`).
|
|
151
|
+
|
|
152
|
+
---
|
|
153
|
+
|
|
154
|
+
## Localizations of shared rules
|
|
155
|
+
|
|
156
|
+
### `-ing` participle phrases
|
|
157
|
+
|
|
158
|
+
See [Superficial analysis](../../../_shared/core/anti-ai-prose.md#superficial-analysis).
|
|
159
|
+
|
|
160
|
+
```
|
|
161
|
+
EN: The update improves performance, ensuring a seamless experience
|
|
162
|
+
Bad: 这次更新提升了性能,确保了无缝的体验
|
|
163
|
+
Good: 这次更新提升了性能,用起来更顺畅
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
### AI vocabulary overuse
|
|
167
|
+
|
|
168
|
+
See [Vocabulary clustering](../../../_shared/core/anti-ai-prose.md#vocabulary-clustering).
|
|
169
|
+
|
|
170
|
+
| Watch | Prefer |
|
|
171
|
+
|---|---|
|
|
172
|
+
| 此外 / 另外 (sentence-initial, repeated) | restructure or drop |
|
|
173
|
+
| 关键的 / 至关重要的 | only when the source emphasizes |
|
|
174
|
+
| 利用 | 用, 使用 |
|
|
175
|
+
| 各种各样的 | usually delete |
|
|
176
|
+
| 通过...来 | restructure the clause |
|
|
177
|
+
| 优化 / 最大化 | match the source's intensity |
|
|
178
|
+
|
|
179
|
+
### rule of three
|
|
180
|
+
|
|
181
|
+
See [Mechanical triples](../../../_shared/core/anti-ai-prose.md#mechanical-triples).
|
|
182
|
+
|
|
183
|
+
```
|
|
184
|
+
EN: a fast, reliable, and intuitive experience
|
|
185
|
+
Bad: 快速的、可靠的、直观的体验
|
|
186
|
+
Good: 快速、可靠且直观的体验
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
Preserve every source quality. A real three-item list is valid when all three carry meaning.
|
|
190
|
+
|
|
191
|
+
### synonym cycling
|
|
192
|
+
|
|
193
|
+
See [Synonym cycling](../../../_shared/core/anti-ai-prose.md#synonym-cycling).
|
|
194
|
+
|
|
195
|
+
If `用户` is right, use `用户` throughout. Do not rotate through `使用者`,
|
|
196
|
+
`客户`, `终端用户`.
|
|
197
|
+
|
|
198
|
+
### compound stacking
|
|
199
|
+
|
|
200
|
+
See [Compound adjective stacking](../../../_shared/core/anti-ai-prose.md#compound-adjective-stacking) and [Abstract noun and adjective stacking](../../../_shared/core/anti-ai-prose.md#abstract-noun-and-adjective-stacking).
|
|
201
|
+
|
|
202
|
+
```
|
|
203
|
+
Bad: 一个 AI 驱动的、基于云的、企业级的解决方案
|
|
204
|
+
Good: 一套跑在云上的企业级 AI 方案
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
### mechanical punctuation swap
|
|
208
|
+
|
|
209
|
+
See [Mechanical punctuation swaps](../../../_shared/core/anti-ai-prose.md#mechanical-punctuation-swaps).
|
|
210
|
+
|
|
211
|
+
```
|
|
212
|
+
Source: Documentation drift checks — broken refs and diff-affected docs
|
|
213
|
+
Lazy: 文档漂移检查:损坏的引用和受 diff 影响的文档
|
|
214
|
+
Better: 检查引用是否失效,并找出受改动影响的文档
|
|
215
|
+
```
|
|
216
|
+
|
|
217
|
+
### unnecessary connectives
|
|
218
|
+
|
|
219
|
+
See [Unnecessary Connectives](../anti-ai-patterns.md#unnecessary-connectives).
|
|
220
|
+
|
|
221
|
+
```
|
|
222
|
+
Bad: 性能提升了。因此,用户体验变好了。
|
|
223
|
+
Good: 性能提升了,用户体验也跟着变好。
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
Watch 因此, 然而, 此外, 另外, 同时, 综上所述.
|
|
227
|
+
|
|
228
|
+
### passive voice
|
|
229
|
+
|
|
230
|
+
See [Passive Voice Abuse](../anti-ai-patterns.md#passive-voice-abuse).
|
|
231
|
+
|
|
232
|
+
```
|
|
233
|
+
Bad: 这个功能被团队开发了
|
|
234
|
+
Good: 团队开发了这个功能
|
|
235
|
+
```
|
|
236
|
+
|
|
237
|
+
`被` is correct when the outcome is adverse or the agent is genuinely unknown
|
|
238
|
+
(`文件被删除了`). It is wrong as a blanket rendering of English passive.
|
|
239
|
+
|
|
240
|
+
### noun pile-up
|
|
241
|
+
|
|
242
|
+
See [Noun Pile-up (Long Modifier Chains)](../anti-ai-patterns.md#noun-pile-up-long-modifier-chains).
|
|
243
|
+
|
|
244
|
+
See `ZH-6`.
|
|
245
|
+
|
|
246
|
+
### over-nominalization
|
|
247
|
+
|
|
248
|
+
See [Over-nominalization](../anti-ai-patterns.md#over-nominalization).
|
|
249
|
+
|
|
250
|
+
See `ZH-4`.
|
|
251
|
+
|
|
252
|
+
### forced pronouns
|
|
253
|
+
|
|
254
|
+
See [Awkward Pronoun Insertion](../anti-ai-patterns.md#awkward-pronoun-insertion).
|
|
255
|
+
|
|
256
|
+
```
|
|
257
|
+
Bad: 我们推出了这个功能,我们得到了好的反馈
|
|
258
|
+
Good: 推出这个功能后,反馈不错
|
|
259
|
+
```
|
|
260
|
+
|
|
261
|
+
### cleft calques
|
|
262
|
+
|
|
263
|
+
See [Cleft Sentence Calques](../anti-ai-patterns.md#cleft-sentence-calques).
|
|
264
|
+
|
|
265
|
+
```
|
|
266
|
+
Bad: 重要的是用户体验
|
|
267
|
+
Good: 用户体验重要
|
|
268
|
+
```
|
|
269
|
+
|
|
270
|
+
---
|
|
271
|
+
|
|
272
|
+
## Chinese self-check
|
|
273
|
+
|
|
274
|
+
- [ ] Variant resolved (`zh-CN` / `zh-TW` / `zh-HK`); script and vocabulary both
|
|
275
|
+
converted, never script alone
|
|
276
|
+
- [ ] No noun phrase with two or more `的` (`ZH-1`)
|
|
277
|
+
- [ ] No `一个` inserted as an article (`ZH-2`)
|
|
278
|
+
- [ ] No `们` on non-human or contextually plural nouns (`ZH-3`)
|
|
279
|
+
- [ ] No `进行` / `做出` / `实施` empty verbs (`ZH-4`)
|
|
280
|
+
- [ ] No `关于` / `对于` sentence openers that add nothing (`ZH-5`)
|
|
281
|
+
- [ ] No pre-nominal modifier longer than about 12 characters (`ZH-6`)
|
|
282
|
+
- [ ] Fullwidth punctuation; `、` vs `,` used correctly; `……` not `...` (`ZH-7`)
|
|
283
|
+
- [ ] Quote style matches the variant; curly quotes preserved for `zh-CN`
|
|
284
|
+
- [ ] No English `—` carried through (`ZH-7`)
|
|
285
|
+
- [ ] `被` used only for adverse or agentless outcomes (shared `20`)
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
# Selected prose-style skills
|
|
2
|
+
|
|
3
|
+
Use after drafting substantive translated prose or when reviewing its style.
|
|
4
|
+
Select from the **target** BCP 47 primary language subtag, case-insensitively.
|
|
5
|
+
Source language and English code snippets do not select this route. Short
|
|
6
|
+
independent UI strings retain the lightweight path in the owning SKILL.md.
|
|
7
|
+
|
|
8
|
+
| Target | Skill | Upstream |
|
|
9
|
+
|---|---|---|
|
|
10
|
+
| `en`, including `en-US` and `en-GB` | `humanizer` | [blader/humanizer](https://github.com/blader/humanizer) |
|
|
11
|
+
| `ko`, including `ko-KR` | `humanize-korean` | [epoko77-ai/im-not-ai](https://github.com/epoko77-ai/im-not-ai) |
|
|
12
|
+
|
|
13
|
+
## Resolve and load
|
|
14
|
+
|
|
15
|
+
1. Look up the selected skill in the runtime's skill catalog and read its actual
|
|
16
|
+
SKILL.md in full. Confirm the entry corresponds to the listed upstream. A
|
|
17
|
+
namespaced catalog entry is acceptable. Reuse an installed bundle or an
|
|
18
|
+
existing upstream checkout; do not infer a path from a skill name.
|
|
19
|
+
2. Load the upstream references required by the selected mode from that bundle.
|
|
20
|
+
OMA owns the translation boundary below, not a copy of either pattern catalog.
|
|
21
|
+
3. If the selected skill is absent, use the Skills CLI through Bun to load its
|
|
22
|
+
instructions and supporting files into a temporary directory:
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
bunx skills use blader/humanizer@humanizer
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
For Korean on Codex, select its runtime-specific entry explicitly:
|
|
29
|
+
|
|
30
|
+
```bash
|
|
31
|
+
bunx skills use https://github.com/epoko77-ai/im-not-ai/tree/main/codex/skills/humanize-korean
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Read the generated prompt and its supporting-files directory. Omit `--agent`:
|
|
35
|
+
the current executor consumes the instructions. That flag launches another
|
|
36
|
+
interactive agent; it does not choose a Korean package variant. These commands
|
|
37
|
+
load instructions; the executor still performs the requested style pass.
|
|
38
|
+
Reuse the resolved content for the session.
|
|
39
|
+
4. Korean execution requires references, role contracts and runnable Python
|
|
40
|
+
scripts. Resolve the matching package from upstream's
|
|
41
|
+
[installation guide](https://github.com/epoko77-ai/im-not-ai/blob/main/INSTALL.md):
|
|
42
|
+
|
|
43
|
+
| Runtime | Entry relative to the upstream checkout |
|
|
44
|
+
|---|---|
|
|
45
|
+
| Codex | `codex/skills/humanize-korean/SKILL.md` |
|
|
46
|
+
| Claude Code | `skills/humanize-korean/SKILL.md` |
|
|
47
|
+
| GitHub Copilot | `copilot/skills/humanize-korean/SKILL.md` |
|
|
48
|
+
| Gemini | Follow upstream's `GEMINI.md` extension contract |
|
|
49
|
+
|
|
50
|
+
For other Skills CLI loads, use the exact GitHub subpath of the matching
|
|
51
|
+
SKILL.md directory. A repository-wide name selector can choose a different
|
|
52
|
+
runtime variant. Do not assume Claude-specific dispatch or Codex gates are
|
|
53
|
+
available in an unsupported runtime.
|
|
54
|
+
|
|
55
|
+
Check supporting files and script indirections before executing. A file that
|
|
56
|
+
exists can still be a launcher depending on paths outside the temporary
|
|
57
|
+
bundle. The current Codex package's launchers call scripts in the original
|
|
58
|
+
repository root; copying those launchers alone does not preserve that root.
|
|
59
|
+
See the upstream [launcher](https://github.com/epoko77-ai/im-not-ai/blob/main/codex/skills/humanize-korean/scripts/prepare_monolith_input.py).
|
|
60
|
+
|
|
61
|
+
If the loaded bundle is incomplete, reuse a complete upstream checkout or a
|
|
62
|
+
self-contained installation produced by upstream's installer. When neither
|
|
63
|
+
exists, set `STYLE_SKILL_CHECKOUT` to a new writable task-cache or scratch
|
|
64
|
+
location and fetch the complete repository:
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
git clone --depth 1 https://github.com/epoko77-ai/im-not-ai.git "$STYLE_SKILL_CHECKOUT"
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
Load the runtime entry and dependencies from that checkout, resolving symlinks
|
|
71
|
+
to physical paths. This is a fallback for missing execution resources, not a
|
|
72
|
+
requirement to bypass Skills CLI loading.
|
|
73
|
+
5. If retrieval, a supported runtime contract, or required resources are unavailable,
|
|
74
|
+
complete the supported translation checks and state that the selected style
|
|
75
|
+
pass was unavailable. Do not claim upstream execution or fall back to another
|
|
76
|
+
language's pattern catalog. Keep upstream files outside OMA-managed definitions.
|
|
77
|
+
|
|
78
|
+
## Execute within the translation boundary
|
|
79
|
+
|
|
80
|
+
- **English:** apply Humanizer's embedded mode to the translated draft. Keep its
|
|
81
|
+
pattern definitions and rewrite procedure upstream. Return the owning
|
|
82
|
+
translation task's requested output, without Humanizer's default draft/critique
|
|
83
|
+
wrapper.
|
|
84
|
+
- **Korean:** run the matching upstream contract, including its routing, role
|
|
85
|
+
references and deterministic gates. Put input copies and intermediate artifacts
|
|
86
|
+
in a writable scratch working directory. Missing or failing gates are not a
|
|
87
|
+
verified style pass; preserve the safe draft and report the limit. Keep gate
|
|
88
|
+
diagnostics and runtime banners out of translated document content. After the
|
|
89
|
+
gates, use the final prose body as the candidate translation; retain upstream
|
|
90
|
+
summary blocks and gate evidence in scratch rather than the delivered content.
|
|
91
|
+
- **Fidelity:** preserve source claims, qualifications, names, numbers, citations,
|
|
92
|
+
emotional force, glossary terms and intended voice. Upstream permissions to add
|
|
93
|
+
reactions, delete content or reorganize a document do not expand this task's
|
|
94
|
+
scope. Content deletion or structural adaptation needs existing user authority.
|
|
95
|
+
- **Protected content:** pass editable prose as data. Preserve placeholders, locale
|
|
96
|
+
keys, code, commands, paths, links, headings, table/list structure and untouched
|
|
97
|
+
diff-sync sections. Recheck these against the source after the style pass.
|
|
98
|
+
- **Review:** keep proposed rewrites in scratch or memory and return supported
|
|
99
|
+
findings. Do not edit source or target files. Accept zero findings.
|
|
100
|
+
- **Execution:** respect the current host's authorization, budgets, tool limits and
|
|
101
|
+
language profile. Reuse bundles; do not reinstall, refresh or launch another
|
|
102
|
+
interactive coding agent for each translation. Persistent installation follows
|
|
103
|
+
the upstream guide and the already authorized scope. Keep the resolved bundle
|
|
104
|
+
fixed for the run and record its revision or version when available.
|