sync-dev-env
Install or update claude-dev-env in a running session, link every enabled plugin's skills into the agents skills directory that Codex reads, and schedule a daily re-sync at 6:00 AM local by default. Use when the user asks to sync claude-dev-env into a session, to link a plugin's skills for Codex, when a /skill fails to resolve, to set up the daily sync, to check which session prompt a session uses, or to turn the claude-dev-env session prompt off for one session.
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 7
- Forks
- 1
01 前言 Front Matter
- name
- sync-dev-env
- description
- Install or update claude-dev-env in a running session, link every enabled plugin's skills into the agents skills directory that Codex reads, and schedule a daily re-sync at 6:00 AM local by default. Use when the user asks to sync claude-dev-env into a session, to link a plugin's skills for Codex, when a /skill fails to resolve, to set up the daily sync, to check which session prompt a session uses, or to turn the claude-dev-env session prompt off for one session.
- argument-hint
- [HH:MM] [IANA time zone]
02 资源文件 7
- 脚本scripts/link_plugin_skills.py9.4 KB
- 脚本scripts/sync_dev_env_constants/__init__.py—
- 脚本scripts/sync_dev_env_constants/config/__init__.py59 B
- 脚本scripts/sync_dev_env_constants/config/constants.py1.2 KB
- 脚本scripts/sync_dev_env_constants/config/test_constants.py664 B
- 脚本scripts/sync_dev_env_constants/test___init__.py135 B
- 脚本scripts/test_link_plugin_skills.py9.2 KB
03 SKILL.md 正文
/sync-dev-env
An always-on session starts once, so a SessionStart hook runs once and never again. Claude Code reads plugins only at session start, and a running session has no plugin reload. Codex reads the agents skills directory live, so one symlink per skill makes each plugin skill load there at once. Claude loads plugin skills under their prefix, such as pstack:name, and this script adds no bare-name links for Claude.
A /skill fails to resolve
Run /reload-skills first. It reloads the skills directory in the running session, so the session keeps its context. When a plugin skill still fails to resolve, check its prefixed name, such as pstack:name. Then run the linker in step 2 for Codex.
1. Install or update the package
Run npx --yes claude-dev-env@latest --update --target ~/.claude.
The installer leaves symlinks in the skills directory in place.
2. Link the plugin skills
Run python3 "${CLAUDE_SKILL_DIR}/scripts/link_plugin_skills.py".
The script reads enabledPlugins from ~/.claude/settings.json and the newest install of each plugin from ~/.claude/plugins/installed_plugins.json. It links each plugin skill by its bare name into ~/.agents/skills, the folder Codex reads. A link it owns points inside ~/.claude/plugins/cache. On each run it re-points an owned link at the current plugin version and removes an owned link whose skill is gone or whose plugin is disabled. When ~/.claude/skills is its own folder, as the installer makes it, the script also removes any owned link left there, so Claude loads each plugin skill once. A name some other skill already holds is skipped and reported.
Tell the user the summary line. Report each skipped name, because a plugin skill that refers to a skipped sibling by ../<name> reaches the other skill.
3. Schedule the daily sync
Skip this step when list_triggers already shows a routine named Daily dev env sync bound to this session.
The time defaults to 6:00 AM in the user's time zone. Take the time and the IANA zone from the arguments. With no zone given and none known, ask for it.
In a Claude Code cloud session, call create_trigger:
name:Daily dev env synccron_expression:CRON_TZ=<zone> <minute> <hour> * * *, with the minute jittered a few minutes early per the tool's guidanceprompt:/sync-dev-envinitiation:human_request
Bind the routine to the session whose container needs the sync. Called from that session, leave persistent_session_id unset. Called from another session, set persistent_session_id to the session that needs the sync. Never set create_new_session_on_fire, because a fresh session gets its own container and syncs nothing the running session reads.
Then call list_triggers and tell the user the routine name and its next_run_at in their time zone. The schedule counts as armed only once that listing shows it.
In a local Claude Code session, CronCreate jobs expire after 7 days. Use /loop or an operating system scheduler for a local daily sync.
Session prompt
The package sets "agent": "dev-env-session" in ~/.claude/settings.json. Claude Code loads that agent's body, ~/.claude/agents/dev-env-session.md, as the system prompt of every session the settings file reaches.
When the user asks which session prompt this session uses, read the agent key in ~/.claude/settings.json, then compare your loaded system prompt with the body of ~/.claude/agents/dev-env-session.md. Report dev-env-session with the file path when the key is set and the body matches your loaded prompt. Report the default Claude Code prompt when the key is absent or the body differs, because a launch flag such as --agent, --system-prompt or --settings overrides the key.
When the user asks to turn the trimmed prompt off for one session, start that session with claude --settings '{"agent": ""}'. The settings file stays unchanged, so the next session loads the trimmed prompt again.
Layout
| File | Role |
|---|---|
SKILL.md |
This flow: install, link, schedule |
scripts/link_plugin_skills.py |
Converges the agents skills directory on one link per enabled plugin skill, and clears plugin links from the Claude folder |
scripts/test_link_plugin_skills.py |
Behavior tests for link, skip, re-point, remove, Claude folder cleanup, and a second run |
scripts/sync_dev_env_constants/config/constants.py |
Plugin file paths, settings keys, outcome names, report lines |
04 同仓库更多 Skills
update
Fast-forwards a local repository's main branch to a remote's main after confirming the repo path and source remote through AskUserQuestion. Use when the user says '/update', 'update main', 'fast-forward main', 'sync main from origin', 'pull latest main into <path>', or 'bring main up to date'.
source-command-sr-loop
Converging cleanup loop: repeat /simplify until clean, then repeat /code-review --fix until clean
skill-builder
Skill lifecycle: classify, scaffold, write via the skill-writer-agent, self-audit, compose sub-skills, polish description triggers, enforce deterministic scripts. Triggers: build a skill, new skill workflow, improve this skill, optimize skill description, skill development lifecycle, skill modularity, skill composition, description trigger catalog, deterministic skill scripts.
session-tidy
Audit, clean, and consolidate session logs in the Obsidian vault. Fixes format drift, resolves orphaned next-steps, updates stale statuses, and generates project rollup summaries. Use when session logs feel cluttered or before starting a new project milestone. Triggers on '/session-tidy', 'tidy sessions', 'clean up session logs', 'session audit'.
session-log
Logs a session report as an HTML page, tracks vault context, extracts decisions, and outputs a /rename command. Use for /session-log, 'journal this session', 'log this work', 'session report', 'summarize/log/record this session', 'save session', 'capture session', or 'document what we did'.
run-claude-dev-env
Build, install, run, and test the claude-dev-env installer. Use when asked to run claude-dev-env, install the Claude Code config into ~/.claude, drive the installer, smoke-test it against a sandbox, or run its test suite.