Shen hua
A Codex skill pack for long-running project work
npx -y skills add fengsihao23-eng/shen-hua --skill shen-huaAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Top-level Shen-Hua long-task agent entrypoint. Use when the user invokes `$shen-hua` or asks Codex to run the full Shen-Hua workflow for complex project work, including planning, runtime queueing, memory retrieval, subagent orchestration, verification, self-review, handoff, automation preparation, and external-sync preparation.
SKILL.md
3.9 KB, as published. Nobody here has run it
Shen-Hua
Shen-Hua is the single entrypoint for the whole long-task skill pack. Use it as the first skill when the user wants the complete system rather than one specialized step.
Trigger Conditions
Use this skill when:
- The user invokes
$shen-hua. - The user asks to use the Shen-Hua system, long-task agent mode, project commander, or full long-task workflow.
- The task may need planning, queueing, memory, runtime gate, subagents, verification, review, and handoff together.
- The user wants a project to be advanced end to end, resumed, monitored, or prepared for automation.
Do Not Trigger
Do not use this skill when:
- The user explicitly invokes a narrower Shen-Hua skill such as
$verification-loopand the task is clearly limited to that step. - The task is a trivial one-shot answer with no project state.
- The user forbids reading/updating
.agent/or using the Shen-Hua runtime.
Startup Workflow
-
Read project rules and memory:
AGENTS.md.agent/PROJECT_BRIEF.md.agent/PLAN.md.agent/TASKS.md.agent/HANDOFF.md.agent/state/tasks.jsonl.agent/state/events.jsonl
-
If runtime files are missing, use
$runtime-operatoror run:py -3 .\.agents\skills\persistent-memory\scripts\shenhua_runtime.py init -
Run or consider the runtime gate before substantial work:
py -3 .\.agents\skills\persistent-memory\scripts\shenhua_runtime.py gate -
Classify the user's request:
resume: continue from.agent/HANDOFF.mdand queue.plan: use$deep-planner.execute: use$project-commander.delegate: use$subagent-orchestratoronly when subagents are available and authorized.verify: use$verification-loop.review: use$self-reviewer.handoff: use$handoff-writer.runtime: use$runtime-operator.
Execution Loop
- Pick the highest-value safe task from the user request or
.agent/state/tasks.jsonl. - Update
.agent/state/events.jsonlwith what is starting. - Use the narrow skill needed for the current phase:
$project-commanderfor main coordination.$deep-plannerbefore risky multi-file work.$runtime-operatorfor queue/search/resume/automation/sync.$subagent-orchestratorfor permitted multi-agent work.$persistent-memoryfor memory hygiene.
- Make changes conservatively and preserve user edits.
- Run
$verification-loopor the runtime gate after changes. - Run
$self-reviewerbefore declaring readiness. - Run
$handoff-writerbefore ending.
Required .agent/ Updates
Every Shen-Hua round must update:
.agent/LOG.md.agent/TASKS.md.agent/HANDOFF.md.agent/state/events.jsonl
When relevant, update:
.agent/PLAN.md.agent/DECISIONS.md.agent/REVIEW_CHECKLIST.md.agent/state/tasks.jsonl.agent/resume-prompt.md.agent/automation-prompt.md.agent/state/sync-export.json
Subagents
Use real subagents only when the user explicitly asks for delegation/parallel agents and the current Codex runtime permits it. Otherwise, simulate the roles locally and record the limitation.
Verification
Before claiming completion, run the strongest applicable check:
py -3 .\.agents\skills\persistent-memory\scripts\shenhua_runtime.py gate
For code projects, also run project-specific build, lint, typecheck, and tests when available.
Output Format
SHEN-HUA STATUS
Mode:
Objective:
Queue:
Actions:
Verification:
Memory updated:
Open risks:
Next action: