القائمة
Advanced Thai token optimization for coding agents with code-aware preservation.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | thai-token-optimizer |
| description | Advanced Thai token optimization for coding agents with code-aware preservation. |
| version | 2.0.0 |
Use this skill when the user wants compact Thai output, Thai prompt compression, token-efficient AI coding workflows, or work inside the Thai Token Optimizer repository.
Canonical identity:
Thai Token Optimizer v2.0
package version: 2.0.0
Do not rename the project, change 2.0.0, remove safety behavior, or weaken preservation rules unless the maintainer explicitly asks.
Make Thai interaction more compact while preserving:
safety
correctness
constraints
reproducibility
technical precision
Priority order:
1. Safety
2. Correctness
3. Constraint preservation
4. Reproducibility
5. Token reduction
6. Brevity
Core rule:
ลด token ได้ แต่ห้ามลดความถูกต้อง ความปลอดภัย หรือเงื่อนไขสำคัญ
Use TTO behavior when any condition is true:
ลด token ไทย, ประหยัด token, ตอบสั้น, thai compact, or token thai.THAI TOKEN OPTIMIZER v2.0 ACTIVE.thai-token-optimizer.README.md, MANUAL.md, AGENTS.md, SKILL.md, hooks/*, adapters/*, benchmarks/*, tests/*, .codex-plugin/*, .claude-plugin/*.Do not over-compress if the user asks for deep teaching, full audit, safety-critical steps, legal/medical/financial guidance, or long-form documentation.
Default output when active:
safe style even if the user asks for short output.Recommended report shape:
แก้แล้ว:
- ...
ทดสอบ:
- ...
หมายเหตุ:
- ...
| Mode | Use For | Behavior |
|---|---|---|
auto | default mixed work | choose full/lite/safe by task risk |
lite | teaching, research, design, documentation | compact but explanatory |
full | low-risk direct answers, commands, small fixes | shortest usable output |
safe | production, DB, auth, payment, secrets, rollback, destructive work | preserve risk/backup/dry-run/verify/rollback |
off | user disables TTO | normal assistant behavior |
Never use full for risky operations.
| Profile | Bias | Behavior |
|---|---|---|
coding | concise implementation | code/patch first, short cause, test command |
command | terminal-first | exact command, expected result, verify command |
research | methodology | keep assumptions, variables, metrics, citation intent |
teaching | learner-friendly | concise steps with useful examples |
paper | formal/safe | preserve academic structure, numbers, constraints |
ultra | maximum compression | low-risk only, minimal prose |
Never mutate these unless explicitly editing them:
.env variablestto keepOptimizer v2.0Examples that must remain exact:
node bin/thai-token-optimizer.js install all
npm test
npm run ci
tto benchmark --strict --default-policy --mtp
tto rollback gemini --dry-run
tto compress --pretty --level auto --target codex --budget 500 --check prompt.txt
codex_hooks = true
"version": "2.0.0"
Switch to safe behavior if the prompt includes or implies:
rm -rf
DROP TABLE
TRUNCATE
DELETE FROM
git reset --hard
git push --force
production
deploy
release
database migration
auth
authorization
payment
secret
API key
token
credential
rollback
backup
uninstall
global config
CI/CD publish
Safe response must include:
risk
backup or dry-run
exact command
verification
rollback when relevant
Do not compress away safety details.
When explaining hook behavior to users, use the unified stage format:
[TTO Stage 1/4] Detect Intent
[TTO Stage 2/4] Compress Candidate
[TTO Stage 3/4] Preserve Critical
[TTO Stage 4/4] Output Compact
Meaning:
| Stage | Meaning |
|---|---|
1/4 Detect Intent | mode/profile/risk/trigger detection |
2/4 Compress Candidate | build compact candidate without dropping critical details |
3/4 Preserve Critical | lock commands, paths, versions, errors, config, safety constraints |
4/4 Output Compact | return concise final output with essential next action |
For Codex hooks that must return JSON, stdout must be valid JSON only. Debug logs must go to stderr or be disabled.
Use exact commands below when guiding users.
tto auto
tto lite
tto full
tto safe
tto off
tto status
tto status --pretty
tto ui
tto dashboard --view overview
tto dashboard --view quality
tto dashboard --view waste
tto dashboard --view trend
tto dashboard --view agents
tto dashboard --view doctor
tto dashboard --view fleet
tto compress --pretty --level auto --target codex --budget 500 --check prompt.txt
tto compress --speculative --diagnostics --check --target codex prompt.txt
tto compress --no-speculative --check --target codex prompt.txt
tto rewrite --pretty --budget 300 prompt.txt
tto estimate --target codex "ข้อความภาษาไทย"
tto estimate --exact --target codex "ข้อความภาษาไทย"
tto preserve original.txt optimized.txt
tto classify --pretty "DROP TABLE users production secret"
Speculative precedence:
1. --no-speculative
2. --speculative
3. state.speculative
tto keep "คำเฉพาะ"
tto forget "คำเฉพาะ"
tto dictionary
Dictionary words are hard-protected.
tto benchmark --pretty --strict --default-policy --mtp
tto quality --pretty
tto coach --pretty
tto coach --apply safe --pretty
tto coach --apply quick --pretty
tto ops --pretty
tto ops scan --pretty
tto ops audit codex --pretty
tto ops context --pretty
tto ops quality --pretty
tto ops drift --pretty
tto ops validate --pretty
tto fleet --pretty
tto fleet --pretty --roots /path/repoA,/path/repoB
tto fleet --pretty --doctor --doctor-target codex
tto fleet --pretty --calibration --session-scan
tto fleet --pretty --calibration --calibration-limit 50 --session-scan
tto calibration status --pretty
tto calibration record --estimated 1200 --real 1350 --target codex
tto calibration from-stats --real-total 25000 --samples 20 --target codex
tto calibration clear
tto checkpoint status --pretty
tto checkpoint list --pretty
tto checkpoint capture "before-change" --pretty
tto checkpoint precompact "before compact" --pretty
tto checkpoint postcompact "after compact" --pretty
tto checkpoint restore latest --pretty
tto cache stats --pretty
tto cache clear
tto context --pretty
tto backup all
tto backups
tto install codex
tto install claude
tto install gemini
tto install opencode
tto install openclaw
tto install hermes
tto install cursor
tto install aider
tto install cline
tto install roo
tto install all
tto install-agents
tto doctor --pretty
tto rollback latest --dry-run
tto rollback latest
tto uninstall all
Use dry-run before rollback. Do not run install/uninstall/rollback in a user environment unless requested.
tto config path
tto config init
tto config get
tto config set defaultMode auto
tto config set defaultProfile coding
tto config set safetyMode strict
tto config set readCache.mode warn
tto config set readCache.mode block
| Target | Integration | Main Command |
|---|---|---|
| Codex | hooks + AGENTS.md | tto install codex |
| Claude Code | settings hooks | tto install claude |
| Gemini CLI | extension + hooks | tto install gemini |
| OpenCode | native plugin + config | tto install opencode |
| OpenClaw | managed hook + config | tto install openclaw |
| Hermes Agent | shell hooks + plugin hooks | tto install hermes |
| Cursor | rule file | tto install cursor |
| Aider | instruction file | tto install aider |
| Cline | rule file | tto install cline |
| Roo Code | rule file | tto install roo |
Important paths:
~/.codex/config.toml
~/.codex/hooks.json
~/.codex/AGENTS.md
~/.claude/settings.json
~/.gemini/extensions/thai-token-optimizer/gemini-extension.json
~/.config/opencode/plugins/thai-token-optimizer.js
~/.cursor/rules/thai-token-optimizer.mdc
~/.aider/thai-token-optimizer.md
~/.cline/rules/thai-token-optimizer.md
~/.roo/rules/thai-token-optimizer.md
When writing docs for this repo:
Thai Token Optimizer v2.0.package version: 2.0.0.quality, coach, ops, fleet, calibration, context, checkpoint, cache, MTP/speculative.docs/* details.doctor --pretty can be WARN depending on local adapter footprint.When asked to test/audit TTO, prefer targeted checks first:
node --check bin/thai-token-optimizer.js
node --test tests/test_pretty_ui.js
node --test tests/test_mtp_speculative.js tests/test_mtp_benchmark.js tests/test_mtp_detectors.js
node --test tests/test_fleet_auditor.js tests/test_session_parsers_integration.js
tto benchmark --pretty --strict --default-policy --mtp
tto doctor --pretty
tto doctor --ci
Full checks:
npm test
npm run test:ci
npm run ci
Report results as:
ผ่าน:
- ...
พบปัญหา:
- ...
ไฟล์ที่แก้:
- ...
ทดสอบ:
- ...
If tests generate artifacts such as benchmarks/regression_report.md or benchmarks/regression_report.json, inspect git status and avoid committing unintended artifacts.
Error:
UserPromptSubmit hook failed
error: hook returned invalid user prompt submit JSON output
or:
Stop hook failed
error: hook returned invalid stop hook JSON output
Likely cause:
Fix direction:
stdout = valid JSON only
stderr = debug logs if needed
fallback = minimal valid JSON, e.g. {"continue":true} when contract allows
Verify:
node --check hooks/tto-mode-tracker.js
node --check hooks/tto-stop-summary.js
tto doctor codex --pretty
doctor --pretty may be WARN if optional adapters are not installed or local agent binaries/configs are absent. That does not automatically mean core compression is broken.
MTP/speculative in TTO is a candidate-selection layer. It can improve token reduction quality, but it is not a guaranteed model inference speedup.
เปิด `token thai auto` แล้ว
ติดตั้งแบบปลอดภัย:
```bash
tto backup codex
tto install codex
tto install-agents
tto doctor codex --pretty
### Bugfix report
```text
แก้แล้ว:
- replace `codex_hooks` เดิมแทนการ insert ซ้ำ
- stop hook คืน valid JSON เท่านั้น
ทดสอบ:
- `node --test tests/test_pretty_ui.js` ผ่าน
เสี่ยง: destructive database operation
backup ก่อน:
```bash
mysqldump -u USER -p DB_NAME > backup.sql
ตรวจเป้าหมาย:
SELECT COUNT(*) FROM users;
ยังไม่ควรรัน DROP TABLE users จนกว่าจะยืนยัน backup, environment, และ rollback plan
---
## 15. Prohibited Behavior
Do not:
- Reintroduce older version labels or stale package identity.
- Remove backup/rollback behavior from risky workflows.
- Compress away hard constraints.
- Mutate commands, paths, config keys, versions, or exact errors.
- Claim exact tokenizer behavior when output is heuristic.
- Claim tests passed without running them.
- Restore all targets when user requested one target.
- Uninstall all targets when user requested one target.
- Print non-JSON logs to stdout from hooks that must return JSON.
- Over-compress educational, production, database, security, auth, payment, or rollback guidance.
---
## 16. Final Rule
Thai Token Optimizer v2.0 should make Thai coding-agent interaction compact, but never at the cost of safety, correctness, constraints, reproducibility, or technical precision.