feat(reflect): add skill optimization pipeline

[haowu1234]

Summary

• add the skill_optimization reflect feature, skill_review trigger, trajectory signal extraction, and candidate aggregation/lifecycle plumbing
• normalize skill optimization candidate governance metadata and wire the CLI/manual trigger path for review runs
• add design notes plus unit/integration coverage for trajectory aggregation, lifecycle, and reflect CLI behavior

Why Now

• issue Add reflect skill optimization from historical tool trajectories #10 needs the end-to-end path from historical tool trajectories to operator-reviewable skill optimization candidates
• this branch also closes the gap where elephant reflect run --features skill_optimization --trigger skill_review needed dedicated CLI coverage and candidate metadata normalization

Linked Issue

• Related Add reflect skill optimization from historical tool trajectories #10

Affected Surfaces

• repo-docs
• agent-text
• agent-exec
• release-ops
• app-scaffold

Validation

make agent-report CHANGED_FILES="apps/cli/cli_main_impl.py apps/reflect/features/skill_optimization.py packages/tools/builtins.py packages/tools/schema_descriptions.py packages/understanding/personal_model_governance.py packages/understanding/runtime.py tests/unit/test_personal_model_lifecycle.py tests/unit/cli/test_reflect_cli.py"
make agent-validate
make agent-lint
make agent-test
PYTHONPATH=. .venv/bin/python -m pytest tests/unit/test_personal_model_lifecycle.py tests/unit/cli/test_reflect_cli.py tests/unit/reflect/test_optimization_lifecycle.py tests/unit/reflect/test_skill_optimization.py

Checklist

• Ran make agent-report CHANGED_FILES="..." or provided the equivalent changed-file context
• Updated the matching source of truth when docs, workflows, templates, or executable rules changed
• Kept the PR to one atomic behavior, harness, or documentation unit
• Commits are signed and use scoped Conventional Commit subjects

Follow-Ups Or Debt

• historical malformed skill optimization candidates in the local state DB still need explicit backfill/cleanup outside this code change

[netlify]

✅ Deploy Preview for rad-granita-26ed35 ready!

Name	Link
🔨 Latest commit	ab311fb
🔍 Latest deploy log	https://app.netlify.com/projects/rad-granita-26ed35/deploys/6a0fc8f5dcc9970008d24b47
😎 Deploy Preview	https://deploy-preview-43--rad-granita-26ed35.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

---

To edit notification comments on pull requests, go to your Netlify project configuration.