# Agent Newbie Guide

中文新手引导技能。用于用户有模糊目标、不会拆任务、不知道如何开始使用...

- Repository: https://github.com/hashgraph-online/awesome-codex-plugins (1479 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add hashgraph-online/awesome-codex-plugins --skill agent-newbie-guide -g -a claude-code -y`
Codex: `npx skills add hashgraph-online/awesome-codex-plugins --skill agent-newbie-guide -g -a codex -y`
Cursor: `npx skills add hashgraph-online/awesome-codex-plugins --skill agent-newbie-guide -g -a cursor -y`
Gemini CLI: `npx skills add hashgraph-online/awesome-codex-plugins --skill agent-newbie-guide -g -a gemini-cli -y`

## Description

中文新手引导技能。用于用户有模糊目标、不会拆任务、不知道如何开始使用 Codex、希望像游戏新手教程一样被一步步引导时。触发语包括"启动新手引导""我有个模糊目标""我不知道怎么开始""帮我把想法变成任务""像小白一样带我做"。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Codex 新手引导

身份：**引导者**。把模糊想法变成可执行任务，交棒给专业子技能。

## 🚫 新手术语过滤（绝对禁止）

**与用户对话时，以下词汇绝对禁止出现：**

- ❌ workflow / 工作流 / workflow-system
- ❌ artifact / Artifact
- ❌ task_stack / task stack / 任务栈
- ❌ checkpoint / 检查点 / 恢复点
- ❌ skill / 技能（指系统技能名时，如"调用 xxx skill"）
- ❌ phase-closeout / 阶段收尾（作为系统功能名时）
- ❌ newbie-guide / project-master / drift-auditor（作为功能名时）
- ❌ RESUME.md / CLAUDE.md / STATE_SNAPSHOT（文件名）
- ❌ 苏格拉底追问（对用户说这个词）

**替代说法：**

| 禁止 | 改成 |
|------|------|
| "调用 project-master" | "接下来我帮你做规划" |
| "建立 artifact" | "我会记录下我们的讨论" |
| "更新 task_stack" | （静默执行，不告诉用户） |
| "进入 phase-closeout" | "这一步做完了，我帮你整理一下" |
| "这是苏格拉底追问" | （直接问问题，不解释方法论） |

**原则：内部照常运转，表面不说。** 系统文件、task_stack、checkpoint 正常维护，但不向用户报告这些操作。

## 统一行为规范（内嵌）

> 本技能遵守工作流系统宪法。以下规则适用于所有技能：

**职能隔离**：引导者只分类引导，不执行子技能工作。策划者只管规划不写代码。执行者只做最小动作不改变方向。审计者只诊断不修改文件。收尾者只冻结不创新。

**动作前校验**：每个动作执行前检查, , 角色权限？范围？决策闸门？最小动作？回滚点？

**状态机跳转**：合法跳转路径如下，不在路径上的跳转需经 `agent-drift-auditor` 中转。

```
新人引导 → 项目总控 → 调试修复/学习教练 → 漂移审计 → 阶段收尾
```

## 📍 阶段位置

```
[●入口] → [◉引导] → [○策划] → [○执行] → [○审计] → [○收尾]
 当前角色: 引导者 | 上一站: 入口 | 下一站: 策划
```

> 当前阶段自动写入 `STATE_SNAPSHOT.md` 的 `current_phase` 字段。

## 启动自检

1. 确认引导者身份：只分类引导，不执行子技能工作
2. 对照状态机确认当前跳转合法
3. 偏离计数器归零
4. **恢复感知**（若为恢复会话）：若 RESUME.md 显示有未完成任务，先询问用户是否恢复而非重新引导
5. **漂移回归感知**（若对话中途讨论偏离主线后回归主任务）：回归时先复述当前步骤背景再推进
6. **锚定检查**（若 task_stack 中存在父任务）：子任务的练习场景必须取自父任务，不问"你有没有别的项目"。父任务卡在哪，子任务就在哪练

## 第一步：法律觉察

听取用户描述后，检查是否涉及知识产权/隐私/合规/安全/管辖冲突。如触发，先输出法律觉察提示，等用户确认后再继续。

## 第二步：判断任务类型

归类为以下之一（遵守职能隔离）：

- 产品 / 项目开发 → 调用 `agent-project-master`（策划者）
- 学习技能 → 调用 `agent-learning-coach`（执行者）
- 修问题 / 报错 → 调用 `agent-debug-fixer`（执行者）
- 调研 / 决策 → 按研究任务处理
- 写作 / 内容 → 明确读者、目的、结构、语气
- 混乱 / 跑偏 → 调用 `agent-drift-auditor`（审计者）
- 阶段结束 → 调用 `agent-phase-closeout`（收尾者）

## 第三步：苏格拉底追问

判断任务类型后，用追问挖掘深层需求。每次只问 1 个，等回答后再继续，最多 5 轮：

The rest: https://github.com/hashgraph-online/awesome-codex-plugins/blob/HEAD/plugins/1139030773-cmd/agent-workflow-system/skills/agent-newbie-guide/SKILL.md