# Shen Hua

> 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.

- **Type:** Skill
- **Install:** `agentstack add skill-fengsihao23-eng-shen-hua-shen-hua`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [fengsihao23-eng](https://agentstack.voostack.com/s/fengsihao23-eng)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [fengsihao23-eng](https://github.com/fengsihao23-eng)
- **Source:** https://github.com/fengsihao23-eng/shen-hua/tree/main/skills/shen-hua

## Install

```sh
agentstack add skill-fengsihao23-eng-shen-hua-shen-hua
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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-loop` and 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

1. 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`
2. If runtime files are missing, use `$runtime-operator` or run:

   ```powershell
   py -3 .\.agents\skills\persistent-memory\scripts\shenhua_runtime.py init
   ```

3. Run or consider the runtime gate before substantial work:

   ```powershell
   py -3 .\.agents\skills\persistent-memory\scripts\shenhua_runtime.py gate
   ```

4. Classify the user's request:
   - `resume`: continue from `.agent/HANDOFF.md` and queue.
   - `plan`: use `$deep-planner`.
   - `execute`: use `$project-commander`.
   - `delegate`: use `$subagent-orchestrator` only when subagents are available and authorized.
   - `verify`: use `$verification-loop`.
   - `review`: use `$self-reviewer`.
   - `handoff`: use `$handoff-writer`.
   - `runtime`: use `$runtime-operator`.

## Execution Loop

1. Pick the highest-value safe task from the user request or `.agent/state/tasks.jsonl`.
2. Update `.agent/state/events.jsonl` with what is starting.
3. Use the narrow skill needed for the current phase:
   - `$project-commander` for main coordination.
   - `$deep-planner` before risky multi-file work.
   - `$runtime-operator` for queue/search/resume/automation/sync.
   - `$subagent-orchestrator` for permitted multi-agent work.
   - `$persistent-memory` for memory hygiene.
4. Make changes conservatively and preserve user edits.
5. Run `$verification-loop` or the runtime gate after changes.
6. Run `$self-reviewer` before declaring readiness.
7. Run `$handoff-writer` before 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:

```powershell
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

```markdown
SHEN-HUA STATUS
Mode:
Objective:
Queue:
Actions:
Verification:
Memory updated:
Open risks:
Next action:
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [fengsihao23-eng](https://github.com/fengsihao23-eng)
- **Source:** [fengsihao23-eng/shen-hua](https://github.com/fengsihao23-eng/shen-hua)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-fengsihao23-eng-shen-hua-shen-hua
- Seller: https://agentstack.voostack.com/s/fengsihao23-eng
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.