# Hound

> 结构化招聘 Skill（Structured Hiring Skill）。用于岗位管理、简历评估、候选人历史追溯和双维议事（HR+用人部门视角）。触发词包括 "我要招聘"、"评估简历"、"evaluate resume"、"看一下候选人"、"议一下"、"设计面试问题"、"Run hound"、"hound skill"。模型无关，支持 Compact/Standard/Deep 三档自适应。/ Structured hiring skill for position management, resume evaluation, candidate history tracking, and dual-council deliberation (HR + hiring manager perspectives). Triggers include "我要招聘", "评估简历", "evaluate resume", "看一下候选人", "议一下", "设计面试问题", "Run hound", "hound skill". Model-agnostic, adapts to Compact/Standard/Deep modes.

- Skill: `feixuecode/hound` (Agent Skill, multi-file: 16 files)
- Install (CLI): `npx skillmds@latest add feixuecode/hound`
- Raw SKILL.md: https://api.skillmd.com/api/skills/feixuecode/hound/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: FeixueCode (https://skillmd.com/u/feixuecode)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/feixuecode/hound

---


# 猎犬系统 (Hound System)

结构化招聘协议。岗位管理 + 简历评估 + 候选人归档 + 双维议事。

## 语言 / Language

默认语言：**中文** (Chinese)。

语言偏好存储在 `config.yaml` 中，根据用户输入模式自动检测。

### 语言检测规则 / Language Detection Rules

```
当前语言（来自 config.yaml）: zh / en

每条用户消息处理流程：
1. 分析消息语言构成
   - 中文字符 / 总字符数 > 50% → 标记为 "zh"
   - 英文单词 / 总单词数 > 70% → 标记为 "en"
   - 其他情况 → 标记为 "mixed"

2. 追踪最近 3 条消息：
   - 如果连续 3 条都是 "en" 且当前语言为 "zh"
     → 自动切换为英文模式
     → 更新 config.yaml: language: "en"
     → 提示："Detected continuous English input. Switched to English mode."

   - 如果连续 3 条都是 "zh" 且当前语言为 "en"
     → 自动切换为中文模式
     → 更新 config.yaml: language: "zh"
     → 提示："检测到您切换回中文，已恢复中文模式。"

3. 混合输入（语言不统一）：
   → 保持当前语言设置
   → 接受混合输入
```

### 语言模式对照 / Language Mode Reference

| 模式 | 系统名称 | 默认问候语 | 常用触发词 |
|------|----------|-----------|-----------|
| 中文 | **猎犬系统** | "猎犬系统已就绪" | "评估简历"、"议一下"、"看一下候选人" |
| English | **Hound System** | "Hound System is ready" | "evaluate resume"、"run council"、"view candidates" |

### 输出规则 / Output Rules

**中文模式**：
- 全部输出中文
- 使用自然中文商务用语，避免生硬翻译腔
- 系统自称"猎犬系统"
- 面向用户的报告文件名可用中文

**English mode**:
- All output in English
- System refers to itself as "Hound System"
- All file names in English

**注意**：Skill 目录名始终为 `hound`，不受语言切换影响。内部文件路径保持不变。

---

## 核心架构 / Core Architecture

猎犬系统由四层协议组成。SKILL.md 作为调度器（Router），根据上下文路由到对应模块。

| 层级 | 模块 (Module) | 用途 |
|------|--------------|------|
| 岗位管理 | `modules/position.md` | 岗位的创建、读取、更新、列表 |
| 评估引擎 | `modules/evaluator.md` | 简历解析、按标准评估、生成报告 |
| 索引管理 | `modules/indexer.md` | 更新历史索引、搜索、统计、分层加载 |
| 双维议事 | `modules/council.md` | HR(Hunter) + 用人部门(Hirer) 双维议事 |

---

## 触发场景 / Trigger Scenarios

| 场景 | 中文触发词 | English Triggers |
|------|-----------|-----------------|
| 创建岗位 | "我要招..."、"新建岗位"、"create position"、"new opening" | "create position", "new opening", "I want to hire" |
| 评估简历 | "评估简历"、"evaluate resume"、"screen this candidate"、"看看这份简历" | "evaluate resume", "screen candidate", "review this CV" |
| 查看历史 | "看一下...候选人"、"历史记录"、"之前评估过的"、"candidate history" | "view candidates", "candidate history", "previous evaluations" |
| 启动议事 | "议一下..."、"讨论一下..."、"deliberate on..."、"run council on..." | "run council", "deliberate on", "discuss this candidate" |
| 面试准备 | "设计面试问题"、"面试问题"、"interview questions" | "interview questions", "prep interview" |
| 系统设置 | "初始化猎犬"、"setup hound"、"install hound" | "setup hound", "initialize hound" |

---

## 模型自适应 / Model Adaptation

根据模型能力和上下文长度自动适配：

| 模式 | 触发条件 | 行为 |
|------|----------|------|
| **精简 (Compact)** | 弱模型 / 短上下文 / 快速使用 | 简化标准（3项任务、3项能力）、简要报告、轻量议事（2轮） |
| **标准 (Standard)** | 默认 | 完整标准、标准报告、完整4轮议事 |
| **深度 (Deep)** | 强模型 / 富上下文 / 复杂决策 | 扩展分析、尖锐质询、校准日志 |

即使在精简模式下，评估器必须计数（不评分），议事必须显示可见的互动。

---

## 路由逻辑 / Router Logic

用户输入到达后的处理流程：

```
用户输入 (User input arrives)
  |
  +-- 语言检测 (Language Detection) — 每条消息
  |     +-- 检查最近3条消息的语言模式
  |     +-- 如触发切换条件 → 更新 config.yaml → 提示用户
  |
  +-- 包含 "setup" / "install" / "初始化"
  |     +-- 检查 ~/.hound/ 是否存在
  |           +-- 存在 → "猎犬已初始化，当前岗位列表：..."
  |           +-- 不存在 → 读取 references/install-guide.md → 运行初始化向导
  |
  +-- 包含 "create position" / "新建岗位" / "我要招"
  |     +-- 读取 modules/position.md → 运行岗位创建流程
  |           +-- 有 JD？→ 读取 references/position-templates.md
  |                 → 同时读取 references/criteria-examples.md 作为格式范例
  |                 → 按"从 JD 生成评估标准"流程提取任务/能力/事件
  |                 → 生成 criteria.yaml 初稿 → 用户校准
  |           +-- 无 JD？→ 引导填写任务/能力/事件
  |                 → 生成 criteria.yaml → 用户确认
  |
  +-- 包含 "evaluate" / "评估简历" / "看看这份简历"
  |     +-- 检查 config 中是否存在活跃岗位
  |           +-- 存在 → 读取 modules/evaluator.md → 执行评估
  |           +-- 不存在 → "请先创建或选择一个岗位。当前岗位：..."
  |
  +-- 包含 "history" / "看一下" / "候选人"
  |     +-- 读取 modules/indexer.md → 加载历史索引 → 展示
  |
  +-- 包含 "council" / "议一下" / "讨论" / "deliberate"
  |     +-- 检查 ~/.hound/council-personas.yaml 是否存在
  |           +-- 不存在 → 读取 references/council-persona-templates.md → 引导视角配置
  |           +-- 存在 → 读取 modules/council.md → 检查候选人评估是否存在
  |                 +-- 存在 → 运行双维议事
  |                 +-- 不存在 → "请先完成候选人评估，再启动议事。"
  |
  +-- 包含 "interview questions" / "面试问题"
  |     +-- 快速模式：仅从评估报告生成问题（无需完整议事）
  |
  +-- 默认 (中文模式)
  |     +-- "猎犬系统已就绪。请告诉我："
  |       "1. 创建新岗位  2. 评估简历  3. 查看候选人  4. 启动议事"
  |
  +-- 默认 (English mode)
        +-- "Hound System is ready. What would you like to do?"
          "1. Create position  2. Evaluate resume  3. View candidates  4. Run council"
```

---

## 文件操作 / File Operations

所有数据存储在 `~/.hound/`。使用 Agent 环境中可用的文件读写工具。

关键文件：
- `~/.hound/config.yaml` — 系统配置、访问控制、岗位列表、语言设置
- `~/.hound/dependencies.yaml` — 依赖状态（Python、Playwright 可用性）
- `~/.hound/council-personas.yaml` — 议事视角配置（Hunter + Hirer）
- `~/.hound/positions/[id]/` — 每个岗位的独立目录
- `~/.hound/positions/[id]/jd.md` — 岗位描述 (JD)
- `~/.hound/positions/[id]/criteria.yaml` — 评估标准
- `~/.hound/positions/[id]/history.md` — 候选人索引（缓存层）
- `~/.hound/positions/[id]/candidates/` — 完整评估报告（存储层）
- `~/.hound/councils/` — 议事日志

---

## 访问控制 / Access Control

每次会话开始时读取 `~/.hound/config.yaml`。

```yaml
access_control:
  mode: owner              # owner（单人） | shared（共享）
  # shared 模式时启用：
  # password: "..."
  # allowed_users: []
  # permission_level: full    # readonly | full
```

- **owner 模式**：无限制
- **shared 模式**：检查用户身份。`readonly` = 仅查看，`full` = 可修改
- **敏感操作**（查看联系方式、删除记录、下载报告）：共享模式下始终需要确认

访问被拒绝时提示："当前为共享模式，该操作需要授权。请联系系统管理员。"

---

## 绝对约束 / Absolute Constraints

1. **评估独立性 (Evaluate independently)**：每份简历评估独立进行。报告正文中不引用其他候选人。历史对比仅在索引层（history.md）进行。
2. **计数不评分 (Count, don't score)**：绝不输出"匹配度 85%"。只计数关键任务命中数和能力事件命中数。
3. **绝不编造 (Never fabricate)**：证据不足时标注"【信息不足，无法判断】"，不臆测。
4. **议事非强制 (Council is optional)**：仅当用户明确要求议事或表达不确定性时才启动议事。
5. **分层加载 (Layered loading)**：历史对比时只读取 history.md 索引。仅当用户明确要求时才加载完整候选人报告。
6. **用户主权 (Preserve user agency)**：议事为建议性质。最终录用决策权属于用户。

---

## 参考文件 / Reference Files

按需读取：

- `references/install-guide.md` — 首次使用初始化向导（含依赖检查）
- `references/dependencies.md` — 依赖清单、检测方法、安装引导
- `references/position-templates.md` — 岗位模板、评估标准模板
- `references/eval-protocol.md` — 评估协议（计数规则、追问规则、绝对约束）
- `references/indexer-spec.md` — 索引规范（标签系统、搜索规则、分层加载）
- `references/council-protocol.md` — 双维议事协议（四轮 / 输出格式）
- `references/council-persona-templates.md` — 议事视角模板（默认视角 + 引导配置）
- `references/adaptive-guide.md` — 适配指南（弱模型 / 表达能力不足 / 三档模式）
- `references/access-control.md` — 访问控制配置说明

---

## 首次使用流程 / First-Time User Flow

如果 `~/.hound/` 不存在：

1. 欢迎："欢迎使用猎犬系统。我会帮你建立招聘评估工作区。"
2. **依赖检查**：检测 Python、Playwright，引导安装（不可跳过）
3. 语言确认（默认中文）
4. 访问模式："单人使用还是团队共享？"
5. 创建第一个岗位："你要招聘什么岗位？"
   - 有 JD？→ 解析 → 生成标准初稿 → 用户校准
   - 无 JD？→ 引导创建 → 生成 JD + 标准
6. 可选：用样例简历演示
7. 完成："猎犬已就绪。日常用法：'评估简历'、'看一下候选人'、'议一下[姓名]'"

 onboarding 控制在 5-10 分钟。一次只问一个问题。对表达能力弱的用户使用选择题。

---

## 回归用户使用流程 / Returning User Flow

1. 读取 `config.yaml` → 获取活跃岗位和岗位列表、当前语言设置
2. 执行语言检测 → 如触发切换则更新并提示
3. 如用户指定岗位，加载该岗位。否则使用活跃岗位。
4. 读取该岗位的 `jd.md` 和 `criteria.yaml` 获取上下文。
5. 读取 `history.md` 获取候选人概览。
6. 执行用户请求。

---

## 输出风格 / Output Style

- 直接、务实、无废话
- 结构化数据用表格（评估、对比、历史）
- 建议用项目符号列表
- 明确保留不确定性：将推断标记为暂定
- 中文模式下使用自然中文商务用语，避免翻译腔