副总裁暂停
- 作者仓库星标 13
- 作者仓库 viepilot
- 领域
- 工程开发
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 92 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @0-CODE · v0.1.1 · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- macOS · Linux · Windows
- 运行环境要求
- Node.js
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 命令执行
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
第 2 步:收集状态
收集: 当前位置:阶段、任务、线路 已完成工作:本次会议完成了什么 剩余工作:还剩下什么 做出的决定:关键决定和理由
第6步:确认
</process> <success_criteria> [ ] 以完整状态创建的 HANDOFF.json [ ] 在阶段目录中创建的 .continue-here.md [ ] 填充特定内容的所有部分
<greeting>
## Invocation Banner
Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
VIEPILOT ► VP-PAUSE v0.1.1 (fw 2.19.0)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```
</greeting>
<version_check>
## Version Update Check (ENH-072)
After displaying the greeting banner, run:
```bash
node "$HOME/.claude/viepilot/bin/vp-tools.cjs" check-update --silent
```
**If exit code = 1** (update available — new version printed to stdout):
Display notice banner before any other output:
```
┌──────────────────────────────────────────────────────────────────┐
│ ✨ ViePilot {latest_version} available (installed: {current}) │
│ npm i -g viepilot && vp-tools install --target {adapter_id} │
└──────────────────────────────────────────────────────────────────┘
```
Replace `{latest_version}` with stdout from the command, `{current}` with the installed
version, `{adapter_id}` with the active adapter (claude-code / cursor / antigravity / codex / copilot).
**If exit code = 0 or command unavailable**: silent, continue.
**Suppression rules:**
- `--no-update-check` flag on skill invocation → skip this step entirely
- `config.json` → `update.check: false` → skip this step entirely
- Show at most once per session (`update_check_done` session guard)
</version_check>
<persona_context>
## Persona Context Injection (ENH-073)
At skill start, run:
```bash
node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona auto-switch
node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona context
```
Inject the output as `## User Persona` context before any task execution.
Silent if command unavailable or errors.
</persona_context>
<adapter id="claude-code">
## A. Skill Invocation
- Skill được gọi khi user mention `vp-pause`, `/vp-pause`, "pause", "dừng", "tạm nghỉ"
- Treat all user text after the skill mention as `{{VP_ARGS}}`
## B. User Prompting
Prompt user conversationally to gather state info.
## C. Tool Usage
Use Claude Code tools: `Bash` (shell), `Read` (file), `Edit` + `Write` (file write/patch),
`Grep` (search), `Glob` (file patterns), `LS`, `WebSearch`, `WebFetch`,
`Agent` (spawn subagent — multi-level nesting supported)
Interactive: `AskUserQuestion` (deferred — preload via ToolSearch before first call)
</adapter>
<adapter id="cursor-agent">
## A. Skill Invocation
Same trigger keywords as claude-code adapter.
## C. Tool Usage
Use Cursor tools: `run_terminal_cmd` (shell), `read_file` (read), `edit_file` (write/edit),
`grep_search` (search), `web_search`, `codebase_search`, `list_dir`, `file_search`
Interactive: text list fallback (AskQuestion available in Plan Mode only; Agent Mode = text)
Subagent: `/multitask` (user command, single-level only — not a callable tool)
MCP limit: 40 tools
</adapter>
<adapter id="antigravity">
## A. Skill Invocation
Same trigger keywords as claude-code adapter.
Skill discovery: LLM-driven (automatic, no slash command needed).
## C. Tool Usage
Use Antigravity tools: `shell` (cmd), `file_read`, `file_write`, MCP plugins
Interactive: text fallback (TUI-based; no formal AskUserQuestion)
Skill path: `.agents/skills/<skill>/SKILL.md` (project) or `~/.gemini/antigravity/skills/` (global)
Note: Gemini CLI deprecated June 18, 2026 — use Antigravity CLI.
</adapter>
<adapter id="codex">
## A. Skill Invocation
Same trigger keywords as claude-code adapter.
## C. Tool Usage
Use Codex tools: `container.exec` (sandboxed shell), `apply_patch` (file write), `web_search`
Interactive: text fallback (TUI Tab/Enter injection)
Config: `~/.codex/config.toml`
</adapter>
<adapter id="copilot">
## A. Skill Invocation
Same trigger keywords as claude-code adapter.
Discovery: User-driven (`@agent-name` in GitHub Copilot Chat).
## C. Tool Usage
Use Copilot tools: `runCommands` (shell), `read`/`readfile` (read), `edit`/`editFiles` (write),
`code_search`, `find_references`
Interactive: `askQuestions` (main agent only — NOT available in subagents; VS Code issue #293745)
Skill path: `.github/agents/<name>.agent.md`
</adapter>
<scope_policy>
## ViePilot Namespace Guard (BUG-004)
- Default mode: only use and reference `vp-*` skills in ViePilot workflows.
- External skills (`non vp-*`) are out of framework scope unless user explicitly opts in.
- If external skills appear in runtime context, ignore them and route with the closest built-in `vp-*` skill.
</scope_policy>
<implementation_routing_guard>
## Implementation routing guard (ENH-021)
- **Handoff state** — does not implement shipping; resume with **`/vp-resume`** then **`/vp-auto`** per plan. See `workflows/request.md`.
</implementation_routing_guard>
<objective>
Save complete work state so it can be resumed from any context.
**Creates/Updates:**
- `.viepilot/HANDOFF.json` - Machine-readable state
- `.viepilot/phases/{current}/.continue-here.md` - Human-readable context
- Git WIP commit
**After:** Safe to close session. Resume with `/vp-resume`
</objective>
<execution_context>
@$HOME/{envToolDir}/workflows/pause-work.md
</execution_context>
<process>
Execute workflow from `@$HOME/{envToolDir}/workflows/pause-work.md`
### Step 1: Detect Current Position
```bash
# Find current phase from TRACKER.md or recent files
Read TRACKER.md → current_phase, current_task
Check PHASE-STATE.md → task status
```
### Step 2: Gather State
Collect:
1. **Current position**: Phase, task, line
2. **Work completed**: What got done this session
3. **Work remaining**: What's left
4. **Decisions made**: Key decisions and rationale
5. **Blockers/issues**: Anything stuck
6. **Human actions pending**: Manual interventions needed
7. **Background processes**: Running servers/watchers
8. **Uncommitted files**: Changes not yet committed
Ask user for clarifications if needed.
### Step 3: Write HANDOFF.json
```json
{
"version": "1.0",
"timestamp": "{ISO8601}",
"phase": "{phase_number}",
"phase_name": "{phase_name}",
"task": "{current_task}",
"total_tasks": "{total}",
"status": "paused",
"completed_tasks": [...],
"remaining_tasks": [...],
"blockers": [...],
"human_actions_pending": [...],
"decisions": [...],
"uncommitted_files": [...],
"next_action": "{specific first action when resuming}",
"context_notes": "{mental state, approach}"
}
```
### Step 4: Write .continue-here.md
```markdown
---
phase: {phase}
task: {task}
total_tasks: {total}
status: in_progress
last_updated: {timestamp}
---
<current_state>
[Where exactly are we? Immediate context]
</current_state>
<completed_work>
- Task 1: [name] - Done
- Task 2: [name] - In progress, [what's done]
</completed_work>
<remaining_work>
- Task 2: [what's left]
- Task 3: Not started
</remaining_work>
<decisions_made>
- Decided [X] because [reason]
</decisions_made>
<blockers>
- [Blocker]: [status/workaround]
</blockers>
<context>
[Mental state, what were you thinking]
</context>
<next_action>
Start with: [specific first action when resuming]
</next_action>
```
### Step 5: Git Commit
```bash
git add -A
git commit -m "wip({phase}): paused at task {task}/{total}"
```
### Step 6: Confirm
```
✓ Work paused successfully
Current state:
- Phase: {phase_name}
- Task: {task} of {total}
- Status: {status}
- Blockers: {count}
Files saved:
- .viepilot/HANDOFF.json
- .viepilot/phases/{phase}/.continue-here.md
To resume: /vp-resume
```
</process>
<success_criteria>
- [ ] HANDOFF.json created with complete state
- [ ] .continue-here.md created in phase directory
- [ ] All sections filled with specific content
- [ ] Uncommitted changes identified
- [ ] Git WIP commit created
- [ ] User knows how to resume
</success_criteria>
章节与文件索引
按说明文件中的顺序排列。
召唤横幅
版本更新检查 (ENH-072)
角色上下文注入 (ENH-073)
A. 技能调用
B. 用户提示
文件/命令 -> {latest_version} · {current} · {adapter_id} · --no-update-check · config.json · update.check: false · update_check_done · ## User Persona
内容校验值 -> e88cb3af1903
当前原文的自动摘译,尚未人工审校。
召唤横幅
将此横幅输出作为每次调用的第一件事 - 在问题、工作或任何其他输出之前:</greeting> <version_check>
版本更新检查 (ENH-072)
显示问候语横幅后,运行: 如果退出代码 = 1(可用更新 — 新版本打印到标准输出):在任何其他输出之前显示通知横幅:将
{latest_version}替换为命令中的 stdout,将{current}替换为已安装的版本,将{adapter_id}替换为活动适配器(claude-code/cursor/antigravity/codex/copilot)。角色上下文注入 (ENH-073)
在技能启动时,运行:在任何任务执行之前将输出作为
## User Persona上下文注入。如果命令不可用或出现错误,则保持沉默。 </persona_context> <适配器id =“claude-code”>A. 技能调用
技能 được gọi khi 用户提及
vp-pause、/vp-pause、“pause”、“dừng”、“tạm nghỉ” 将技能提及后的所有用户文本视为{{VP_ARGS}}B. 用户提示
以对话方式提示用户收集状态信息。