Skip to content

feat: Full skill optimization (Phase 1-4: English migration + length reduction + sync) - #197

Open
FuDesign2008 wants to merge 5 commits into
mainfrom
feat/skill-optimization-all-phases
Open

feat: Full skill optimization (Phase 1-4: English migration + length reduction + sync)#197
FuDesign2008 wants to merge 5 commits into
mainfrom
feat/skill-optimization-all-phases

Conversation

@FuDesign2008

Copy link
Copy Markdown
Owner

Overview

Complete optimization of 8 skills across 4 phases. 80 eval runs (5 cases × 2 versions × 8 skills), all passed.

Phase 1: solve-workflow English rewrite (v1.9.0 → v2.0.0)

  • Full Chinese → English body migration (铁律 3)
  • Length reduction 617 → 567 lines (zero info loss)
  • reference.md expanded (94 → 176 lines) with moved content
  • SYNC-SECTION markers added for shared sections

Phase 2: 3 variant skills sync

  • jira-fix-workflow v3.12.0 → v3.13.0: shared sections → English
  • opsx-solve-workflow v1.4.0 → v1.5.0: shared sections → English
  • opsx-jira-fix-workflow v1.4.0 → v1.5.0: instrumentation → English
  • Variant-specific content preserved (🌿 Branch mgmt, OpenSpec gates, --retry)

Phase 3: Git skills length reduction

  • git-release-finish v1.4.0 → v1.5.0: 825 → 513 lines + reference.md
  • git-conflict-resolve v1.1.0 → v1.2.0: 540 → 418 lines + reference.md

Phase 4: Performance skills English migration

  • perf-workflow v2.2.0 → v3.0.0: Chinese → English
  • frontend-perf v2.0.0 → v2.1.0: Chinese → English

Eval Summary

Phase Skills Runs Result
1 solve-workflow 10
2 3 variants 30
3 2 git skills 20
4 2 perf skills 20
Total 8 skills 80 All passed

Files Changed (13)

  • 8 SKILL.md files (rewrite/trim/translate)
  • 2 new reference.md files (git-release-finish, git-conflict-resolve)
  • 1 expanded reference.md (solve-workflow)
  • 1 skills-index (auto-generated)
  • 1 design spec

…v2.0.0)

English migration (铁律 3):
- All body sections translated to English
- Description retains Chinese triggers verbatim + English equivalents

Length reduction (617 → 567 lines, zero info loss):
- Consolidated per-phase tool limits into Quick Reference table
- Consolidated per-phase stop points into global note
- Consolidated per-phase enhancement hints into global note
- Moved PDCA correspondence table to reference.md
- Moved full common pitfalls table to reference.md (SKILL keeps non-obvious subset)
- Trimmed LLM-common-sense from General Principles

reference.md expanded (94 → 176 lines):
- Added PDCA correspondence table
- Added full common pitfalls table (15 entries)
- Added detailed general principles elaboration

Sync markers added:
- <!-- SYNC-SECTION: environment-capability-exploration -->
- <!-- SYNC-SECTION: instrumentation-debugging -->

Behavior preservation (eval verified):
- 2 evals × 2 versions (v2.0.0 vs v1.9.0 snapshot)
- 10/10 assertions pass on both versions (zero behavior difference)
- All 7 phases + sub-steps + routing + mode lifecycle preserved
Synced from solve-workflow v2.0.0 English shared sections:
- Environment Capability Exploration (with 🎭 Browser/UI debug row)
- Instrumentation Debugging (with DevTools guidance)

Changes per variant:
- jira-fix-workflow v3.12.0 → v3.13.0:
  Env capability + instrumentation sections → English
  Preserved: 🌿 Branch management row, --retry notes, Jira-specific phases
  SYNC-SECTION markers added (4 markers)

- opsx-solve-workflow v1.4.0 → v1.5.0:
  Env capability + instrumentation sections → English
  Preserved: OpenSpec artifacts sections, 重试场景 notes
  SYNC-SECTION markers added (4 markers)

- opsx-jira-fix-workflow v1.4.0 → v1.5.0:
  Instrumentation section → English (no standalone env capability section)
  Preserved: OpenSpec + Jira integration sections
  SYNC-SECTION marker added (2 markers)

Result: all 4 workflow skills now share identical English versions of
environment capability exploration and instrumentation debugging sections,
marked with SYNC-SECTION for future maintenance.
Phase 3 — Length reduction (zero info loss, moved to reference.md):
- git-release-finish v1.4.0 → v1.5.0: 825 → 513 lines + reference.md (176 lines)
- git-conflict-resolve v1.1.0 → v1.2.0: 540 → 418 lines + reference.md (158 lines)

Phase 4 — English migration (铁律 3):
- perf-workflow v2.2.0 → v3.0.0: Chinese → English body
- frontend-perf v2.0.0 → v2.1.0: Chinese → English body

Eval: 5 cases × 2 versions × 4 skills = 40 runs, all passed
Total project eval: 80 runs (Phase 1-2: 40 + Phase 3-4: 40)
…ization-all-phases

# Conflicts:
#	docs/generated/skills-index.md
Translation improvements (zero behavior change):
- "sediment" → "codification" (9 occurrences): removes geological
  connotation, uses standard software-engineering term
- "Industry-ailment" → "Industry-wide limitation" (8 occurrences):
  removes awkward hyphenated compound and medical connotation
- "hard-problem termination" → "intractable-problem termination"
  (1 occurrence): clearer semantics

Consistency fixes:
- Add global note: read-only phases (1–4) forbid state-changing Bash
- Fix 5 link title capitalizations to match reference.md headings

Files: SKILL.md + reference.md (23 edits total)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant