# t_console

**Repository Path**: zkkcreated/t_console

## Basic Information

- **Project Name**: t_console
- **Description**: hhhhhhhhhhhhhhhhhhhhhhhhhhh
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-20
- **Last Updated**: 2026-01-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# qoder 任务工作台

qoder 任务工作台是一个基于 AI 的任务管理系统,通过 Skills、Rules 和 MCP Servers 实现任务的全生命周期管理。

## 目录

- [系统架构](#系统架构)
- [Skills 说明](#skills-说明)
- [Rules 说明](#rules-说明)
- [MCP Servers 说明](#mcp-servers-说明)
- [快速开始](#快速开始)

---

## 系统架构

qoder 采用三层架构:

```
用户输入
    ↓
Skills 自动触发层 (根据关键词自动识别并执行技能)
    ↓
MCP Servers 层 (提供工具和功能)
    ↓
Obsidian Vault (数据持久化)
```

**核心特性:**

1. **自动触发机制** - 检测到关键词时自动执行对应 Skill,无需用户确认
2. **智能推荐** - 基于当前状态智能推荐下一步操作
3. **激活任务管理** - 维护当前激活任务,避免重复指定
4. **父子任务联动** - 父子任务状态自动同步

---

## Skills 说明

Skills 是可复用的技能模块,每个 Skill 定义了完整的执行流程。

### 核心 Skills

#### 1. create-task - 创建任务

**功能:** 创建新的父任务

**触发关键词:**
- "实现"、"开发"、"添加"、"做一个"、"写一个"
- "创建一个功能"、"开发功能"、"新建功能"、"添加功能"
- "build"、"implement"、"add feature"

**使用示例:**
```
用户: "实现一个用户登录功能"
AI: 自动触发 create-task,创建任务
```

**MCP 工具:**
- Sequential Thinking (`sequentialthinking`)
- Obsidian (`obsidian_update_note`, `obsidian_global_search`)

---

#### 2. update-task - 更新需求

**功能:** 更新任务需求,支持手动输入、URL获取和网络搜索

**触发关键词:**
- 需求更新: "补充"、"添加需求"、"更新需求"、"需要支持"
- 网络搜索: "搜索竞品"、"查找竞品"、"竞品分析"
- URL 模式: 包含 URL 且明确提到任务名称

**特殊模式 - URL + 任务名称提取 (P0 优先级):**
```
用户: "旅翼行程导入任务 http://example.com/requirements 这是需求文档"
AI: 自动执行以下步骤:
  1. 提取任务名称: "旅翼行程导入任务"
  2. 检查任务是否存在
  3. 不存在则创建任务(create-task)
  4. 从 URL 获取需求(fetch-requirements)
  5. 更新任务需求(update-task)
```

**MCP 工具:**
- Sequential Thinking (`sequentialthinking`)
- BingCN (`bing_search`, `crawl_webpage`)
- Playwright (浏览器工具)
- Obsidian (`obsidian_read_note`, `obsidian_update_note`, `obsidian_manage_tags`)

---

#### 3. split-task - 拆解子任务

**功能:** 将父任务拆解为多个子任务

**触发关键词:**
- "拆解"、"分解"、"拆分为"、"分解为"
- "子任务"、"拆成"
- "split"、"break down"、"subtasks"

**使用示例:**
```
用户: "把这个任务拆解为子任务"
AI: 自动分析任务复杂度,拆解为 2-5 个子任务
```

**MCP 工具:**
- Sequential Thinking (`sequentialthinking`)
- BingCN (`bing_search`)
- Obsidian (`obsidian_read_note`, `obsidian_update_note`, `obsidian_list_notes`)

---

#### 4. update-status - 更新状态

**功能:** 更新任务状态

**触发关键词:**
- 状态更新: "开始"、"完成"、"标记为完成"
- 进度更新: "进行中"、"正在做"
- 暂停: "暂停"、"挂起"

**状态定义:**
- `#todo` - 待开始
- `#doing` - 进行中
- `#paused` - 暂停
- `#done` - 已完成

**MCP 工具:**
- Obsidian (`obsidian_manage_frontmatter`, `obsidian_manage_tags`)

---

#### 5. fetch-requirements - 从 URL 获取需求

**功能:** 从 URL 自动提取需求内容

**触发关键词:**
- "需求在"、"需求文档"、"需求地址"
- "从 URL"、"访问这个链接"

**使用示例:**
```
用户: "需求文档在 https://example.com/requirements"
AI: 使用 Playwright 访问 URL,解析页面内容,提取需求
```

**MCP 工具:**
- Sequential Thinking (`sequentialthinking`)
- Playwright (`browser_navigate`, `browser_snapshot`, `browser_close`)
- Obsidian (`obsidian_read_note`, `obsidian_update_note`)

---

#### 6. list-tasks - 任务列表

**功能:** 查询和展示任务列表

**支持查询维度:**
- 状态 (#todo, #doing, #paused, #done)
- 类型 (parent, child)
- 时间范围 (本周, 本月)
- 关键词搜索

---

#### 7. view-task - 查看任务

**功能:** 查看任务详细信息

---

#### 8. manage-active-task - 激活任务管理

**功能:** 切换和管理当前激活任务

**触发关键词:**
- "切换任务"、"当前任务"、"激活任务"

---

#### 9. manage-dependencies - 依赖关系管理

**功能:** 设置和管理任务间的依赖关系

---

#### 10. validate-requirements - 需求验证

**功能:** 验证需求的完整性、一致性和合理性

**触发关键词:** 
- "评审需求"、"审核需求"、"验证需求"
- "需求评审"、"需求审核"、"需求验证"
- "检查需求完整性"、"验证需求有效性"

**使用示例:**
```
用户: "验证一下这个需求"
AI: 自动触发 validate-requirements,验证需求质量
```

**MCP 工具:**
- Sequential Thinking (`sequentialthinking`)
- Obsidian (`obsidian_read_note`, `obsidian_update_note`)

---

#### 11. set-dependencies - 设置依赖

**功能:** 快速设置任务依赖

---

#### 12. review-task - 任务回顾

**功能:** 完成任务后进行回顾和总结

---

#### 13. archive-task - 任务归档

**功能:** 归档已完成的任务

---

#### 14. manage-knowledge - 知识管理

**功能:** 管理项目相关知识库

---

### Skills 自动触发机制

**核心原则:** 检测到明确意图后,立即执行,禁止询问

**触发优先级:**
1. **P0**: URL + 任务名称提取 (最高优先级)
2. **P1**: create-task (创建任务)
3. **P2**: fetch-requirements (URL 获取)
4. **P3**: split-task (任务拆解)
5. **P4**: validate-requirements (需求验证)
6. **P5**: update-status (状态更新)
7. **P6**: update-task (需求更新)

**强制触发规则:**
- ✅ 检测到明确的关键词匹配 → 立即触发
- ✅ 上下文支持该操作 → 立即触发
- ❌ 禁止询问用户确认
- ❌ 禁止列出多个选项让用户选择

**智能推荐机制:**
每个 Skill 执行完成后,基于当前状态智能推荐下一步操作:
- 新创建的任务 → 推荐"补充需求"或"网络搜索"
- 更新需求后 → 推荐"验证需求"或"拆解子任务"
- 拆解子任务后 → 推荐"开始第一个子任务"

---

## Rules 说明

Rules 是系统的规范性文件,定义了任务管理的各种规则和流程。

### 核心规则

#### 01-任务命名规范.md
**作用:** 定义任务和子任务的命名规范

**父任务命名:**
- 使用简洁、描述性的中文或英文命名
- 长度: 4-20 个字符
- 避免特殊字符

**子任务命名:**
- 格式: `[父任务名]-[序号]-[简述]`
- 序号: 两位数字,从 01 开始
- 简述: 2-8 个字符

---

#### 02-需求更新规范.md
**作用:** 定义需求更新的格式和流程

**更新类型:**
- 手动新增
- URL 获取
- 网络搜索
- 修改
- 删除

**更新格式:**
```markdown
## 需求补充

### [YYYY-MM-DD] [更新类型]
**来源:** [来源说明]

- [需求1]
- [需求2]
```

**需求更新历史表格:** 记录所有需求变更历史

---

#### 03-任务状态转换规范.md
**作用:** 定义任务状态的转换规则

**状态定义:**
- `#todo` → `#doing` → `#done`
- `#doing` → `#paused` → `#doing`
- `#todo/#doing/#paused` → `#cancelled`

**父子任务联动:**
- 子任务完成 → 检查父任务是否也完成
- 父任务取消 → 所有子任务也取消
- 父任务暂停 → 进行中的子任务也暂停

---

#### 04-MCP工具调用规范.md
**作用:** 定义 MCP 工具调用的统一规范

**两步调用原则:**
1. 使用 `mcp_get_tool_description` 获取工具描述
2. 使用 `mcp_call_tool` 执行操作

**MCP 工具分类:**
- Obsidian MCP Server
- Sequential Thinking MCP Server
- BingCN MCP Server
- Playwright MCP Server

---

#### 05-Skills触发规范.md
**作用:** 定义 Skills 的触发关键词和优先级

**触发原则:**

1. **关键词优先原则** - 检测到明确关键词时立即触发对应技能
2. **上下文关联原则** - 结合当前上下文确定最合适的技能
3. **唯一触发原则** - 每次用户输入只触发一个最匹配的技能
4. **回退原则** - 当多个技能匹配时，按优先级执行最高者

**技能触发映射:**

##### P4 优先级: validate-requirements
- **触发关键词**:
  - "评审需求"、"审核需求"、"验证需求"
  - "需求评审"、"需求审核"、"需求验证"
  - "评审.*需求"、"审核.*需求"、"验证.*需求"
  - "需求.*评审"、"需求.*审核"、"需求.*验证"
  - "检查.*需求.*完整性"、"验证.*需求.*有效性"
- **执行技能**: validate-requirements
- **强制规则**: 检测到此类关键词时，必须执行此技能，禁止执行其他技能
1. 关键词优先原则
2. 上下文关联原则
3. 唯一触发原则
4. 回退原则

---

#### 06-激活任务管理规范.md
**作用:** 定义激活任务的存储和管理

**存储位置:**
```
obsidian-vault/System/active-task.md
```

**自动切换规则:**
- 创建任务后自动激活新任务
- 完成子任务后激活下一个待开始子任务
- 父任务取消时清空激活任务

---

#### 07-任务查询统计规范.md
**作用:** 定义任务查询、统计、搜索的规则

**查询维度:**
- 状态、类型、标签、时间范围、激活状态、关键词

**输出格式:**
- 任务列表
- 任务统计
- 任务搜索结果
- 任务详情

---

#### 08-任务依赖关系规范.md
**作用:** 定义任务依赖关系的设置和管理

---

#### 09-需求验证规范.md
**作用:** 定义需求验证的标准和流程

---

#### 10-任务归档规范.md
**作用:** 定义任务归档的条件和流程

---

#### 11-需求验证规范.md
**作用:** 定义需求验证的标准和流程

---

#### 12-知识沉淀规范.md
**作用:** 定义知识笔记的创建和管理

**知识笔记路径:**
```
Resources/Knowledge/[任务名]-需求知识.md
```

---

#### 13-任务回顾规范.md
**作用:** 定义任务回顾的内容和格式

---

#### 14-需求验证触发规范.md
**作用:** 定义何时触发需求验证技能的规则

---

#### 15-URL需求获取优化规范.md
**作用:** 优化从 URL 获取需求的流程

---

#### 15-Skills自动触发机制.md
**作用:** 定义 Skills 的自动触发机制 (详细说明见 Skills 部分)

---

#### 16-用户偏好学习规范.md
**作用:** 定义用户偏好的学习和记录

---

#### 17-错误自动恢复规范.md
**作用:** 定义错误的自动恢复机制

---

#### 18-URL任务提取触发规范.md
**作用:** 定义 URL + 任务名称提取的特殊规则

---

#### obsidian-operations.md
**作用:** 定义所有 Obsidian 操作必须使用 MCP 工具

**核心原则:**
- ✅ 只使用 Obsidian MCP 工具
- ❌ 禁止使用 `read_file`、`write_to_file` 等通用工具
- 路径使用相对路径

**可用工具:**
- `obsidian_read_note` - 读取笔记
- `obsidian_update_note` - 更新笔记
- `obsidian_list_notes` - 列出文件
- `obsidian_delete_note` - 删除笔记
- `obsidian_global_search` - 全局搜索
- `obsidian_search_replace` - 搜索替换
- `obsidian_manage_frontmatter` - 管理 frontmatter
- `obsidian_manage_tags` - 管理标签

---

## MCP Servers 说明

MCP Servers 是提供各种工具和功能的服务。

### 1. BingCN MCP Server

**功能:** 中文网络搜索和网页抓取

**工具:**

| 工具名称 | 用途 | 使用场景 |
|---------|------|---------|
| `bing_search` | 使用必应中文搜索引擎 | 搜索竞品、最佳实践 |
| `crawl_webpage` | 抓取网页内容 | 获取网页详细内容 |

**使用场景:**
- 搜索竞品功能
- 查找最佳实践
- 获取技术文档
- 需求补充和验证

**示例:**
```javascript
// 搜索竞品
bing_search({
  query: "用户登录最佳实践 2026"
})

// 抓取网页
crawl_webpage({
  uuid: "webpage-uuid"
})
```

---

### 2. Obsidian MCP Server

**功能:** Obsidian 知识库的读写和管理

**工具:**

| 工具名称 | 用途 | 使用场景 |
|---------|------|---------|
| `obsidian_read_note` | 读取笔记内容 | 读取任务文档、知识笔记 |
| `obsidian_update_note` | 更新笔记内容 | 创建/更新任务文档 |
| `obsidian_list_notes` | 列出文件和目录 | 浏览任务目录结构 |
| `obsidian_delete_note` | 删除笔记 | 删除任务文档 |
| `obsidian_global_search` | 全局搜索 | 搜索历史任务、知识 |
| `obsidian_search_replace` | 搜索替换 | 批量替换内容 |
| `obsidian_manage_frontmatter` | 管理 frontmatter | 更新任务状态、元数据 |
| `obsidian_manage_tags` | 管理标签 | 添加/删除标签 |

**路径规范:**
- 使用相对路径 (相对于 obsidian-vault 根目录)
- 使用正斜杠 `/` 分隔目录
- 不包含盘符或绝对路径

**示例:**
```javascript
// 读取任务
obsidian_read_note({
  path: "Tasks/用户登录/task.md",
  format: "markdown"
})

// 创建任务
obsidian_update_note({
  path: "Tasks/用户登录/task.md",
  operation: "overwrite",
  content: taskContent
})

// 搜索任务
obsidian_global_search({
  query: "登录",
  page: 1,
  pageSize: 20
})
```

**核心原则:**
- 所有 Obsidian 操作必须通过 MCP 工具执行
- 禁止使用通用文件操作工具

---

### 3. Playwright MCP Server

**功能:** 浏览器自动化,用于访问网页

**工具:**

| 工具名称 | 用途 | 使用场景 |
|---------|------|---------|
| `browser_navigate` | 导航到 URL | 访问需求文档 URL |
| `browser_snapshot` | 获取页面快照 | 获取页面内容 |
| `browser_close` | 关闭页面 | 完成访问后关闭 |

**使用场景:**
- 从 URL 获取需求内容
- 访问在线文档
- 抓取网页数据

**示例:**
```javascript
// 访问 URL
browser_navigate({ url: "https://example.com/requirements" })

// 等待页面加载
browser_wait_for({ timeout: 3000 })

// 获取页面内容
browser_evaluate({
  expression: "document.body.innerText"
})

// 关闭浏览器
browser_close()
```

---

### 4. Sequential Thinking MCP Server

**功能:** 深度思考和规划

**工具:**

| 工具名称 | 用途 | 使用场景 |
|---------|------|---------|
| `sequentialthinking` | 动态反思性问题解决 | 所有 Skill 执行前 |

**使用场景:**
- 任务创建前的规划
- 任务拆解前的分析
- 需求更新前的思考
- 状态更新前的验证

**参数说明:**
- `thought`: 当前思考步骤
- `nextThoughtNeeded`: 是否需要继续思考
- `thoughtNumber`: 思考步骤编号
- `totalThoughts`: 预估总思考步骤
- `isRevision`: 是否修订之前的思考
- `revisesThought`: 修订哪个思考步骤

**示例:**
```javascript
sequentialthinking({
  thought: "分析用户输入,识别要创建的任务",
  thoughtNumber: 1,
  totalThoughts: 5,
  nextThoughtNeeded: true
})
```

**核心价值:**
- 动态调整思考过程
- 修订之前的想法
- 生成假设并验证
- 提供准确的答案

---

## MCP 服务器配置

以下是 MCP 服务器的配置示例，您可以根据需要修改配置参数：

```json
{
  "mcpServers": {
    "Sequential Thinking MCP Server": {
      "timeout": 60000,
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ],
      "type": "stdio",
      "disabled": false
    },
    "word-document-server": {
      "command": "D:\\mcp\\Office-Word-MCP-Server\\venv\\Scripts\\python.exe",
      "args": [
        "D:\\mcp\\Office-Word-MCP-Server\\word_mcp_server.py"
      ]
    },
    "context7": {
      "args": [
        "-y",
        "@upstash/context7-mcp"
      ],
      "command": "npx",
      "type": "stdio",
      "disabled": false
    },
    "playwright": {
      "args": [
        "@playwright/mcp@latest"
      ],
      "command": "npx"
    },
    "paddleocr-ocr": {
      "command": "D:/mcp/paddleocr/paddleocr-env/Scripts/paddleocr_mcp.exe",
      "args": [],
      "env": {
        "PADDLEOCR_MCP_PIPELINE": "OCR",
        "PADDLEOCR_MCP_PPOCR_SOURCE": "local"
      }
    },
    "trc_mysql": {
      "command": "C:/Users/zkkorz/AppData/Local/Programs/Python/Python311/Scripts/mysql_mcp_server.exe",
      "env": {
        "MYSQL_DATABASE": "trc",
        "MYSQL_HOST": "10.32.0.177",
        "MYSQL_PASSWORD": "Trc1234@2024",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "trc"
      }
    },
    "obsidian-mcp-server": {
      "command": "node",
      "args": [
        "D:/project/work/node_modules/obsidian-mcp-server/dist/index.js"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "76baa4c0c49646728125171232543aa50eae4c2804395c543218c1a377df922a",
        "VERIFY_SSL": "false",
        "OBSIDIAN_PROTOCOL": "http",
        "OBSIDIAN_HOST": "127.0.0.1",
        "OBSIDIAN_PORT": "27124"
      },
      "disabled": false
    },
    "bingcnmcp": {
      "type": "streamable_http",
      "url": "https://mcp.api-inference.modelscope.net/c7c7a46b59b440/mcp"
    }
  }
}
```

### 配置说明

- **Sequential Thinking MCP Server**: 用于动态反思性问题解决
- **word-document-server**: 用于 Word 文档处理
- **context7**: 用于查询编程库文档和代码示例
- **playwright**: 用于浏览器自动化
- **paddleocr-ocr**: 用于图像和PDF文本提取
- **trc_mysql**: 用于MySQL数据库操作
- **obsidian-mcp-server**: 用于Obsidian知识库管理
- **bingcnmcp**: 用于中文网络搜索

---

## 快速开始

### 1. 创建任务

```
用户: "实现一个用户登录功能"
```

系统将:
1. 自动识别触发关键词"实现"
2. 使用 Sequential Thinking 分析任务
3. 创建任务文档
4. 激活新任务
5. 推荐下一步操作

### 2. 补充需求

```
用户: "需要支持手机号和邮箱登录"
```

系统将:
1. 自动识别触发关键词"需要支持"
2. 读取当前激活任务
3. 更新需求内容
4. 创建需求更新历史
5. 推荐下一步操作

### 3. 从 URL 获取需求 (特殊模式)

```
用户: "旅翼行程导入任务 http://example.com/requirements 这是需求文档"
```

系统将:
1. 检测到 URL + 任务名称模式 (P0 优先级)
2. 提取任务名称: "旅翼行程导入任务"
3. 检查任务是否存在
4. 不存在则创建任务
5. 使用 Playwright 访问 URL
6. 解析页面内容,提取需求
7. 更新任务需求
8. 推荐下一步操作

### 4. 拆解子任务

```
用户: "把这个任务拆解为子任务"
```

系统将:
1. 自动识别触发关键词"拆解"
2. 分析任务需求和复杂度
3. 拆解为 2-5 个子任务
4. 创建子任务文档
5. 更新父任务
6. 推荐下一步操作

### 5. 更新状态

```
用户: "开始这个任务"
```

系统将:
1. 自动识别触发关键词"开始"
2. 更新任务状态为 #doing
3. 记录实现记录
4. 检查父子任务联动
5. 推荐下一步操作

---

## 工作流程示例

### 完整任务生命周期

```
1. 创建任务
   用户: "实现用户登录功能"
   → 触发: create-task

2. 补充需求
   用户: "需求在 https://example.com/requirements"
   → 触发: fetch-requirements

3. 网络搜索
   用户: "搜索竞品"
   → 触发: update-task (网络搜索模式)

4. 验证需求
   用户: "验证需求"
   → 触发: validate-requirements

5. 拆解子任务
   用户: "拆解任务"
   → 触发: split-task

6. 开始实现
   用户: "开始任务"
   → 触发: update-status

7. 完成任务
   用户: "完成任务"
   → 触发: update-status

8. 任务回顾
   用户: "回顾任务"
   → 触发: review-task

9. 任务归档
   用户: "归档任务"
   → 触发: archive-task
```

---

## 技术架构

### 文件结构

```
t_console/
├── .qoder/
│   ├── rules/          # 规范文件
│   │   ├── 01-任务命名规范.md
│   │   ├── 02-需求更新规范.md
│   │   ├── ...
│   │   └── obsidian-operations.md
│   └── skills/         # 技能文件
│       ├── create-task.md
│       ├── update-task.md
│       ├── ...
│       └── archive-task.md
├── .qoder/
│   ├── docs/
│   ├── rules/
│   └── skills/
├── obsidian-vault/
│   ├── Tasks/         # 任务存储
│   │   ├── [任务名]/
│   │   │   └── task.md
│   │   └── [父任务]/
│   │       └── subtasks/
│   │           └── [子任务]/
│   │               └── task.md
│   ├── Resources/     # 资源存储
│   │   └── Knowledge/
│   └── System/        # 系统文件
│       ├── active-task.md
│       └── user-preferences.md
├── .config.json      # MCP 服务器配置文件
└── README.md
```

---

## 核心优势

1. **智能自动化** - 检测意图自动触发,无需重复确认
2. **统一规范** - Rules 定义了完整的规范体系
3. **模块化** - Skills 可复用,易于扩展
4. **数据持久化** - Obsidian Vault 存储所有数据
5. **知识沉淀** - 自动创建和管理知识笔记
6. **智能推荐** - 基于上下文推荐下一步操作

---

## 开发和扩展

### 添加新 Skill

1. 在 `.qoder/skills/` 下创建新的 Skill 文件
2. 定义触发关键词
3. 定义 MCP 工具调用
4. 定义执行流程
5. 定义输出格式
6. 在 `15-Skills自动触发机制.md` 中添加触发规则

### 添加新 Rule

1. 在 `.qoder/rules/` 下创建新的 Rule 文件
2. 定义规则说明
3. 定义规则内容
4. 定义验证规则
5. 更新相关 Skill 文件

---

## 相关资源

- **Skills 规范:** `.qoder/skills/`
- **Rules 规范:** `.qoder/rules/`
- **Obsidian Vault:** `obsidian-vault/`

---

**版本:** v1.0
**最后更新:** 2026-01-20