القائمة
Manage idev's optional hooks without editing settings — show status, enable/disable the auto-learning observer and compact suggester, and install the team git commit hooks.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Senior backend architect for system design decisions — service decomposition, database schema design, API contract governance, migration strategy, reliability and observability patterns. Use when designing a new backend system or service, choosing between monolith/microservices, designing schemas or APIs, or planning a data migration. Advisory only — produces specifications, does not write code.
Branch synchronization agent — merges the team base branch into the current feature branch before a PR, resolves merge conflicts with three-way evidence and intent analysis, verifies the merge with a build and targeted tests, and reports what was merged and how each conflict was resolved. Use when preparing a branch for a PR, when a PR has conflicts with its target, or when asked to sync/update a feature branch with developer/main.
Browser testing agent — verifies web features and user flows end-to-end by writing and running re-runnable Playwright scripts, capturing screenshot/console/network evidence, and producing structured test reports. Use when a UI change needs real-browser verification, a user flow needs smoke testing, a UI bug needs reproduction, or the user asks to test the site in a browser and report results.
Expert code reviewer providing constructive, prioritized feedback on correctness, security, maintainability, performance, and test coverage — not style preferences. Use when reviewing a diff, branch, or PR for general quality. For a security-only deep audit, use the security-reviewer agent instead.
Expert frontend developer for building and improving web UI — components, state management, responsive layouts, accessibility, and Core Web Vitals performance. Use when implementing UI features or component libraries, fixing layout/responsiveness issues, improving accessibility compliance, or optimizing bundle size and page performance.
"Codebase onboarding specialist — builds fast, accurate mental models of unfamiliar repositories by reading source, tracing execution paths, and stating only facts grounded in inspected code. Use when onboarding into a new codebase, asking "where should I start", "what owns this behavior", or "how does a request flow through this system". Strictly read-only and descriptive — no reviews, refactors, or recommendations."
| name | hooks |
| description | Manage idev's optional hooks without editing settings — show status, enable/disable the auto-learning observer and compact suggester, and install the team git commit hooks. |
Manage the plugin's optional hooks. They are pre-registered in the plugin's
hooks/hooks.json but off by default — each script exits instantly unless
its opt-in flag exists. Toggling a flag takes effect immediately (no restart,
no settings.json editing).
Arguments: $ARGUMENTS
| Hook | Flag file | Scope |
|---|---|---|
observer (auto-learning capture) | ~/.codex/homunculus/enabled | global, all projects |
compact (/compact suggestions) | <project>/.codex/idev/compact-suggestions-enabled | per project |
status (default when no arguments)Check both flag files and report each hook as ENABLED/DISABLED, plus:
~/.codex/homunculus/observations.jsonl if present, and whether the background analyzer is running (bash "${PLUGIN_ROOT}/skills/auto-learning/agents/start-observer.sh" status)IDEV_COMPACT_THRESHOLD, default 50).git/hooks/commit-msg and .git/hooks/prepare-commit-msg are the idev versions (check for the # idev marker line)enable observer / disable observermkdir -p ~/.codex/homunculus && touch ~/.codex/homunculus/enabled # enable
rm -f ~/.codex/homunculus/enabled # disable
On enable, remind the user: observations capture tool inputs/outputs
(secret-redacted) to ~/.codex/homunculus/; tools can be filtered via the
plugin's skills/auto-learning/config.json.
enable compact / disable compactmkdir -p .codex/idev && touch .codex/idev/compact-suggestions-enabled # enable
rm -f .codex/idev/compact-suggestions-enabled # disable
Run from the project root. Requires .codex/idev/ (run $idev:idev-init first).
install-git-hooksInstalls the team commit-message hooks into the current repo:
git rev-parse --git-dir); find the hooks dir
(respect core.hooksPath if set).prepare-commit-msg and commit-msg: if a hook already exists
and is NOT an idev hook (no # idev marker), do not overwrite — show the
user both and ask how to proceed (chain it, replace it, or skip).${PLUGIN_ROOT}/templates/git-hooks/ and chmod +x both..codex/idev/commit-style.md doesn't exist, copy
${PLUGIN_ROOT}/templates/commit-style.md there and tell the user to
tune it (it's the source of truth the commit-style skill reads).$idev:hooks install-git-hooks
too, or the team commits the hooks dir and sets core.hooksPath.Report the new state of all toggles (a compact status table).