Skip to content

Add Codex session repair skill and cross-platform docs - #1

Merged
WardLu merged 5 commits into
mainfrom
codex/codex-cross-provider-session-repair
Aug 1, 2026
Merged

Add Codex session repair skill and cross-platform docs#1
WardLu merged 5 commits into
mainfrom
codex/codex-cross-provider-session-repair

Conversation

@WardLu

@WardLu WardLu commented Aug 1, 2026

Copy link
Copy Markdown
Owner

Summary

  • Add codex-cross-provider-session-repair, a backup-first repair skill for migrated or provider-switched Codex Desktop sessions.
  • Add bilingual English and Simplified Chinese documentation, npx installation guidance, and Windows/macOS/Linux installers.
  • Clarify that this repository is a general-purpose agent skills collection; the current skill is Codex-specific.

Validation

  • 4 offline unit tests passed.
  • README audits passed for the root and skill documentation.
  • POSIX installer syntax and .skill packaging were verified on the feature branch.

@ecc-tools

ecc-tools Bot commented Aug 1, 2026

Copy link
Copy Markdown

Analyzing 200 commits...

@WardLu
WardLu merged commit d95a074 into main Aug 1, 2026
1 check passed
@WardLu
WardLu deleted the codex/codex-cross-provider-session-repair branch August 1, 2026 06:52
@ecc-tools

ecc-tools Bot commented Aug 1, 2026

Copy link
Copy Markdown

Analysis Complete

Generated ECC bundle from 5 commits | Confidence: 50%

View Pull Request #2

Repository Profile
Attribute Value
Language Python
Framework Not detected
Commit Convention conventional
Test Directory mixed
Changed Files (17)
Metric Value
Files changed 17
Additions 1222
Deletions 0

Top hotspots

Path Status +/-
codex-cross-provider-session-repair/scripts/repair.py added +349 / -0
codex-cross-provider-session-repair/README.md added +148 / -0
codex-cross-provider-session-repair/README.zh-CN.md added +148 / -0
codex-cross-provider-session-repair/SKILL.md added +128 / -0
README.md added +128 / -0

Top directories

Directory Files Total changes
codex-cross-provider-session-repair 9 500
codex-cross-provider-session-repair/scripts 4 428
. 1 128
codex-cross-provider-session-repair/tests 1 97
codex-cross-provider-session-repair/evals 1 38
Analysis Depth Readiness (evidence-backed, 57%)

ECC Tools uses this to decide whether recommendations should stay at commit-history/setup guidance or expand into CI, security, harness, reference-set, AI-routing, and team backlog work.

Area Status Evidence / Next Step
Commit history Ready 5 commits sampled
CI/CD signals Ready .github/workflows/validate-skills.yml
Security evidence Ready codex-cross-provider-session-repair/SECURITY.md
Harness configuration Missing Add Claude, Codex, OpenCode, Zed, dmux, MCP, plugin, or cross-harness config evidence for harness-agnostic recommendations.
Reference/eval evidence Ready codex-cross-provider-session-repair/evals/evals.json
AI routing and cost controls Missing Add model-routing, budget, usage, or cost-control files before relying on AI-heavy automation recommendations.
Team handoff and project tracking Missing Add roadmap, runbook, project, Linear, or follow-up tracking docs so generated work can land in a team queue.
Reference Set Readiness (1/7, 14%)
Area Status Evidence / Next Step
Deep analyzer corpus Missing Add analyzer fixture, golden, benchmark, or reference-set files that can catch analyzer regressions.
RAG/evaluator comparison Missing Add retrieval or evaluator reference-set comparison fixtures with expected ranking behavior.
PR salvage/review corpus Missing Add stale-PR, review-thread, reopen-flow, or salvage reference cases for queue cleanup automation.
Discussion triage corpus Missing Add public discussion triage fixtures, golden cases, or reference sets for informational, answered, and no-response classifications.
Harness compatibility Missing Add cross-harness, adapter-compliance, or harness-audit evidence for Claude, Codex, OpenCode, Zed, dmux, and agent surfaces.
Security evidence Present codex-cross-provider-session-repair/SECURITY.md
CI failure-mode evidence Missing Add captured CI failure logs, dry-run fixtures, or troubleshooting docs for common workflow failure modes.
Likely Future Issues (3)
Severity Signal Why it may show up
HIGH Regression coverage may lag behind the diff 5 generic code paths changed; 0 test files changed
MEDIUM CI workflow changes may ship without failure-mode evidence 1 CI/test-runner paths changed; 0 CI failure-mode evidence artifacts changed
MEDIUM Dependency or CI drift could surface after merge CI/workflow files changed; no lockfile changes detected
  • Regression coverage may lag behind the diff: The PR changes multiple code paths but does not touch any obvious test files.
  • CI workflow changes may ship without failure-mode evidence: The PR changes CI workflows or test-runner entrypoints without touching CI failure fixtures, captured logs, troubleshooting notes, or regression evidence.
  • Dependency or CI drift could surface after merge: Package or workflow changes landed without an accompanying lockfile update, which often turns into CI or release noise later.
Suggested Follow-up Work (3)
Type Suggested title Targets
PR test: add regression coverage for codex-cross-provider-session-repair/scripts/install.ps1 + codex-cross-provider-session-repair/scripts/install.sh codex-cross-provider-session-repair/scripts/install.ps1, codex-cross-provider-session-repair/scripts/install.sh
PR ci: add failure-mode evidence for .github/workflows/validate-skills.yml .github/workflows/validate-skills.yml
PR chore: refresh lockfile and validate CI after dependency updates .github/workflows/validate-skills.yml
  • test: add regression coverage for codex-cross-provider-session-repair/scripts/install.ps1 + codex-cross-provider-session-repair/scripts/install.sh: Backfill regression coverage before another change set lands on the touched code paths.
  • ci: add failure-mode evidence for .github/workflows/validate-skills.yml: Backfill CI failure-mode evidence before another workflow or test-runner change lands on the touched surface.
  • chore: refresh lockfile and validate CI after dependency updates: Package or workflow changes without a lockfile refresh tend to turn into noisy follow-up fixes after merge.

Copy-ready bodies

test: add regression coverage for codex-cross-provider-session-repair/scripts/install.ps1 + codex-cross-provider-session-repair/scripts/install.sh

## Summary
- Add regression coverage for the recently touched code paths before more changes stack on top.

## Why
- Backfill regression coverage before another change set lands on the touched code paths.

## Touched paths
- `codex-cross-provider-session-repair/scripts/install.ps1`
- `codex-cross-provider-session-repair/scripts/install.sh`

## Validation
- Add or extend focused tests that exercise the touched paths.
- Run the affected test suite and verify the new coverage closes the gap.

ci: add failure-mode evidence for .github/workflows/validate-skills.yml

## Summary
- Add CI failure-mode evidence for the recently changed workflow or test-runner surface.

## Why
- Backfill CI failure-mode evidence before another workflow or test-runner change lands on the touched surface.

## Touched paths
- `.github/workflows/validate-skills.yml`

## Validation
- Add or update a CI failure fixture, captured failing log, troubleshooting note, workflow dry-run evidence, or regression test for the changed CI/test-runner behavior.
- Run the affected workflow or test-runner entrypoint locally or in CI and record pass/fail evidence.

chore: refresh lockfile and validate CI after dependency updates

## Summary
- Refresh the lockfile and rerun CI after the dependency or workflow changes in this PR.

## Why
- Package or workflow changes without a lockfile refresh tend to turn into noisy follow-up fixes after merge.

## Touched paths
- `.github/workflows/validate-skills.yml`

## Validation
- Refresh the lockfile in the same package manager used by the repo.
- Run the repo typecheck / test / CI entrypoints that depend on the updated package graph.
Detected Workflows (2)
Workflow Description
update-documentation-files Updates documentation files for the repository or a specific skill, including README, CHANGELOG, and related markdown files.
add-or-enhance-skill-package Adds a new skill package or enhances an existing one by updating code, scripts, tests, and documentation within the skill directory.
Generated Instincts (20)
Domain Count
git 5
code-style 9
workflow 4
testing 2

After merging, import with:

/instinct-import .claude/homunculus/instincts/inherited/skills-instincts.yaml

Files

  • .claude/ecc-tools.json
  • .claude/skills/skills/SKILL.md
  • .agents/skills/skills/SKILL.md
  • .agents/skills/skills/agents/openai.yaml
  • .claude/identity.json
  • .codex/config.toml
  • .codex/AGENTS.md
  • .codex/agents/explorer.toml
  • .codex/agents/reviewer.toml
  • .codex/agents/docs-researcher.toml
  • .claude/homunculus/instincts/inherited/skills-instincts.yaml
  • .claude/commands/update-documentation-files.md
  • .claude/commands/add-or-enhance-skill-package.md

ECC Tools | Everything Claude Code

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