update skills

Author: Your Name

README.md

@@ -20,78 +20,29 @@
 
 ## 快速安装
 
-### Linux/macOS 安装 (install.sh)
+### 按 Tag 安装（推荐 — install-by-tag）
 
-统一支持**系统级别**和**项目级别**安装，支持按文件夹选择安装：
+`install-by-tag.sh` / `install-by-tag.ps1` 根据 SKILL.md frontmatter 中的 `tags` 字段批量安装。默认扫描 `dev/`、`analysis/`、`office-skills/` 以及 `references/skills-pool/` 下的所有分类目录：
 
 ```bash
-# 查看可用 skills
-./install.sh --list
-
-# 查看可用 skill 文件夹
-./install.sh --list-folders
-
-# ========== 系统级别安装 ==========
-# 安装所有 skills 到系统目录（所有 Agent）
-./install.sh --system --all
-
-# 安装所有 skills 到特定 Agent（如 Kimi）
-./install.sh --system --agent kimi --all
-
-# 从特定文件夹安装（如 dev）
-./install.sh --system --folder dev --all
-
-# 安装指定 skills 到系统
-./install.sh --system github-task-workflow local-workflow
-
-# ========== 项目级别安装 ==========
-# 安装所有 skills 到当前项目
-./install.sh --project --all
-
-# 从特定文件夹安装到当前项目
-./install.sh --project --folder dev --all
-
-# 安装指定 skills 到当前项目
-./install.sh --project github-task-workflow
-```
-
-**系统级别安装位置**：
-- `~/.config/agents/skills/` (通用)
-- `~/.claude/skills/` (Claude Code)
-- `~/.kimi/skills/` (Kimi CLI)
-- `~/.codex/skills/` (Codex)
-- `~/.opencode/skills/` (OpenCode)
-- `~/.trae/skills/` (Trae / Trae Solo)
-- `~/.workbuddy/skills/` (WorkBuddy)
-
-**项目级别安装位置**：
-- `./.agents/skills/` (通用)
-- `./.kimi/skills/` (Kimi CLI)
-- `./.claude/skills/` (Claude Code)
-- `./.trae/skills/` (Trae / Trae Solo)
-- `./.workbuddy/skills/` (WorkBuddy)
-- 自动创建 `.kimi/KIMI.md` 项目配置
-- 自动创建 `tasks/` 目录
-
-### 按 Tag 安装（install-by-tag）
-
-`install-by-tag.sh` / `install-by-tag.ps1` 根据 SKILL.md frontmatter 中的 `tags` 字段批量安装。默认扫描 `dev/`、`analysis/`、`fe-skills/`、`backend-skills/`、`product/` 五个分类目录：
-
-```bash
-# 安装所有带 analysis 标签的 skill（含 repo-analyzer）
+# 安装所有带 analysis 标签的 skill（含 repo-analyzer、tech-research 等）
 ./install-by-tag.sh analysis --system
 
 # 安装所有 dev-workflow 标签 skill 到 Claude Code
 ./install-by-tag.sh dev-workflow --system --agent claude-code
 
+# 安装 office 类技能（markdown-converter、python-uv-env）
+./install-by-tag.sh office --system
+
 # 仅扫描指定目录（可重复传 --dir）
 ./install-by-tag.sh repo --system --dir ./analysis
+./install-by-tag.sh research --system --dir ./dev --dir ./analysis
 
 # Windows
 .\install-by-tag.ps1 -Tag analysis -System
 ```
 
-常用 tag：`dev-workflow` · `github` · `workflow` · `analysis` · `codegraph` · `repo` · `research` · `security` · `ai`
+常用 tag：`dev-workflow` · `github` · `workflow` · `analysis` · `codegraph` · `repo` · `research` · `security` · `ai` · `office` · `python`
 
 ### 清理已安装的 Skills
 
@@ -125,88 +76,87 @@ ln -s $(pwd)/dev/git-workflow ~/.claude/skills/git-workflow
 | **local-workflow** | 纯本地任务追踪，无需 GitHub | 本地 tracing、AI Agent Protocol 输出捕获、编排器 |
 | **github-cli-skill** | GitHub CLI (`gh`) 快速参考 | 仓库管理、Issue CRUD、Python 集成示例 |
 | **gh-create-release** | GitHub Release 创建工具 | 一键创建 Release + 上传 Assets |
-| **ai-config** | 一键配置 AI Provider 到编程工具 | GLM/OpenRouter/OpenAI/Anthropic 模板，支持 Claude Code/Codex/OpenCode/Cline/OpenClaw |
-| **spark-task-init-skill** | 初始化 spark-cli 任务目录结构 | 创建 tasks/features/ 等标准目录 |
 | **scanning-for-secrets** | 提交前扫描敏感信息 | 9 种 Token 模式检测 + Pre-commit Hook |
-| **tech-research** | 技术问题解决方案搜索与分析 | Web 搜索、结构化分析报告、技术成熟度评估 |
-| **awesome-analyzer** | 代码/项目分析工具 | 项目结构分析 |
+| **understand-anything** | 交互式代码知识图谱 | 将代码库转为可搜索、可探索的交互式知识图谱 |
 
-安装：`./install.sh --system --folder dev --all`
+安装：`./install-by-tag.sh dev-workflow --system`
 
 ### `analysis/` — 代码分析 Skills
 
 | Skill | 说明 | 核心能力 |
 |-------|------|---------|
 | **repo-analyzer** | 代码仓库语义分析（基于 [CodeGraph](https://github.com/colbymchenry/codegraph)） | 克隆/扫描仓库 → 生成结构化分析报告，归档到 `~/innate-revisit/analysis/repo/<repo-name>/` |
+| **tech-research** | 技术问题解决方案搜索与分析 | Web 搜索、结构化分析报告、技术成熟度评估 |
+| **awesome-analyzer** | Awesome List 解析与项目分析 | Awesome List 项目信息提取与结构分析 |
 
 安装（按 tag）：`./install-by-tag.sh analysis --system`
 
-### `fe-skills/` — 前端开发 Skills
+### `office-skills/` — 办公效率 Skills
 
 | Skill | 说明 | 核心能力 |
 |-------|------|---------|
-| **innate-frontend** | Web 前端开发，基于 `@innate/ui` 组件库 | 57+ UI 组件、7 个 Landing 区块、Auth/Mail/Chat 业务区块、OKLCH 主题系统 |
-| **desktop-app** | Tauri 2 + Next.js 跨平台桌面/Web 应用 | 完整 monorepo 模板、侧边栏布局、Tauri IPC 通信、可选 PTY 终端 |
-
-安装：`./install.sh --system --folder fe-skills --all`
-
-### `backend-skills/` — 后端开发 Skills
-
-| Skill | 说明 |
-|-------|------|
-| **golang-cli-app** | Go CLI 应用开发指南 |
+| **markdown-converter** | 文档转 Markdown（基于 markitdown） | 支持 PDF/Word/PPT/Excel/HTML/图片/音频/ZIP/YouTube → Markdown |
+| **python-uv-env** | Python 项目脚手架（基于 uv） | 一键创建 CLI/FastAPI/Django/Library 项目，自动配置 ruff/mypy/pytest |
 
-安装：`./install.sh --system --folder backend-skills --all`
+安装（按 tag）：`./install-by-tag.sh office --system`
 
-### `product/` — 产品设计 Skills
+### `references/skills-pool/` — 更多分类 Skills
 
-| Skill | 说明 |
-|-------|------|
-| **prd-writer-skill** | PRD 撰写 |
-| **project-analysis-skill** | 项目分析设计 |
+| 子目录 | 说明 | 包含 Skill |
+|--------|------|-----------|
+| **fe-skills/** | 前端开发 | innate-frontend（Web 前端，@innate/ui + Next.js 16） |
+| **backend-skills/** | 后端开发 | golang-cli-app（Go CLI 应用开发指南） |
+| **product/** | 产品设计 | prd-writer-skill、project-analysis-skill |
+| **ai-config/** | AI Provider 配置 | 一键配置 GLM/OpenRouter/OpenAI/Anthropic 到编程工具 |
 
-安装：`./install.sh --system --folder product --all`
+安装（按 tag）：`./install-by-tag.sh <tag> --system --dir ./references/skills-pool/<subdir>`
 
 ## 仓库结构
 
 ```
 fire-skills/
 ├── README.md                          # 本文件
-├── install.sh                         # 统一安装脚本（支持 --folder/--system/--project）
+├── CLAUDE.md                          # Claude Code 项目指令
+├── install-by-tag.sh                  # 按 Tag 批量安装脚本（macOS/Linux）
+├── install-by-tag.ps1                 # 按 Tag 批量安装脚本（Windows）
 ├── clean-skills.sh                    # 清理已安装 Skills 的脚本
+├── package.json                       # 文档站点构建（docmd）
+├── docmd.config.mjs                   # 文档站点配置
 ├── docs/                              # 详细文档
-│   ├── README.md                      # 文档索引
-│   ├── Agents.md                      # 支持的 AI Agent 工具介绍
-│   ├── ai-coding-tools-guide.md       # AI 编程工具配置指南
-│   ├── spec/                          # 协议和规范定义
-│   └── usage/                         # 使用指南
-├── dev/                               # 开发工作流 Skills (10 个)
+│   ├── README.md                      #   文档索引
+│   ├── index.md                       #   文档首页
+│   ├── Agents.md                      #   支持的 AI Agent 工具介绍
+│   ├── ai-coding-tools-guide.md       #   AI 编程工具配置指南
+│   ├── spec/                          #   协议和规范定义
+│   ├── usage/                         #   使用指南
+│   └── validation/                    #   验证文档
+├── dev/                               # 开发工作流 Skills (6 个)
 │   ├── git-workflow/                  #   GitHub Issue 任务工作流
 │   ├── local-workflow/                #   本地任务工作流
 │   ├── github-cli-skill/              #   GitHub CLI 工具
 │   ├── gh-create-release/             #   GitHub Release 创建
-│   ├── ai-config/                     #   AI Provider 一键配置
-│   ├── spark-task-init-skill/         #   任务目录初始化
 │   ├── scanning-for-secrets/          #   安全扫描
+│   └── understand-anything/           #   交互式代码知识图谱
+├── analysis/                          # 代码分析 Skills (3 个)
+│   ├── repo-analyzer/                 #   代码仓库语义分析（CodeGraph 集成）
 │   ├── tech-research/                 #   技术调研
-│   └── awesome-analyzer/              #   awesome list 解析
-├── analysis/                          # 代码分析 Skills (1 个)
-│   └── repo-analyzer/                 #   代码仓库语义分析（CodeGraph 集成）
-├── fe-skills/                         # 前端开发 Skills (2 个)
-│   ├── innate-frontend/               #   Web 前端开发（@innate/ui）
-│   └── desktop-app/                   #   桌面应用开发（Tauri + Next.js）
-├── backend-skills/                    # 后端开发 Skills (1 个)
-│   └── golang-cli-app/                #   Go CLI 应用开发
-├── product/                           # 产品设计 Skills (2 个)
-│   ├── prd-writer-skill/              #   PRD 撰写
-│   └── project-analysis-skill/        #   项目分析设计
+│   └── awesome-analyzer/              #   Awesome List 解析
+├── office-skills/                     # 办公效率 Skills (2 个)
+│   ├── markdown-converter/            #   文档转 Markdown
+│   └── python-uv-env/                 #   Python 项目脚手架（uv）
 ├── references/                        # 参考资料
+│   ├── skills-pool/                   #   更多 Skills 池
+│   │   ├── fe-skills/                 #     前端开发（innate-frontend）
+│   │   ├── backend-skills/            #     后端开发（golang-cli-app）
+│   │   ├── product/                   #     产品设计
+│   │   ├── ai-config/                 #     AI Provider 配置
+│   │   └── ...                        #     更多分类
 │   ├── composio/                      #   Composio SDK 参考实现
-│   ├── mattprocock-skills/            #   社区 Skills 参考
-│   └── skills-pool/                   #   Superpowers 等 Skills 池
+│   └── mattprocock-skills/            #   社区 Skills 参考
+├── python-skills-runtime/             # Python Skills 运行时环境
 └── tasks/                             # 任务管理目录
     ├── issues/                        #   任务定义文件
-    ├── features/                      #   功能特性任务
+    ├── tracing/                       #   本地执行追踪
     └── analysis/                      #   分析任务
 ```
 
@@ -227,7 +177,7 @@ npm run docs:build  # 构建到 site/
 
 ## 添加新 Skill
 
-1. 在对应分类目录下（`dev/`、`analysis/`、`fe-skills/`、`backend-skills/`、`product/`）创建新文件夹
+1. 在对应分类目录下（`dev/`、`analysis/`、`office-skills/` 或 `references/skills-pool/<subdir>/`）创建新文件夹
 2. 编写 `SKILL.md`，包含标准的 YAML frontmatter：
 
 ```yaml
@@ -242,17 +192,19 @@ supported_agents:
   - trae
   - trae-solo
   - workbuddy
+tags:
+  - your-tag
 ---
 ```
 
 3. 在 `SKILL.md` 同级目录下按需创建 `scripts/`、`references/` 等子目录
 4. 更新本 README 的 Skill 列表
-5. 运行 `./install.sh --system --folder <folder> --all` 安装
+5. 运行 `./install-by-tag.sh <your-tag> --system` 安装
 
 ## 设计原则
 
 - **单一入口**：每个 skill 只有一个 `SKILL.md`，降低维护成本
-- **分类组织**：Skills 按功能分目录（dev/analysis/fe-skills/backend-skills/product），支持 `--folder` 选择安装
+- **Tag 分类**：Skills 按 frontmatter `tags` 字段分类，支持跨目录按主题批量安装
 - **无外部强依赖**：优先使用标准库或系统自带工具
 - **脚本自解释**：所有 Python 脚本均内置 `--help`
 - **配置分层**：支持 CLI > 环境变量 > 项目配置 > 全局配置的优先级链

analysis/README.md

@@ -7,6 +7,8 @@
 | Skill | 说明 |
 |-------|------|
 | **repo-analyzer** | 代码仓库语义分析。克隆任意 GitHub / 本地仓库，集成 [CodeGraph](https://github.com/colbymchenry/codegraph) 构建索引（可选），生成结构化分析报告（技术栈 / 架构 / 入口点 / 路由表），归档到 `~/innate-revisit/analysis/repo/<repo-name>/`。 |
+| **tech-research** | 技术问题解决方案搜索与分析。Web 搜索 + 结构化分析报告 + 技术成熟度评估。 |
+| **awesome-analyzer** | Awesome List 解析与项目分析。从 Awesome List 中提取项目信息并做结构化分析。 |
 
 ## 安装
 

dev/README.md

@@ -7,9 +7,23 @@
 | Skill | 说明 |
 |-------|------|
 | **git-workflow** | 基于 GitHub CLI 的任务工作流（创建 Issue → 执行 → 关闭） |
-| **github-cli-skill** | 简化版 GitHub CLI 工具（仓库创建、Issue 管理） |
 | **local-workflow** | 本地任务工作流（无需 GitHub，本地追踪记录） |
+| **github-cli-skill** | 简化版 GitHub CLI 工具（仓库创建、Issue 管理） |
 | **gh-create-release** | GitHub Release 创建工具 |
-| **scanning-for-secrets** | 代码安全扫描 |
+| **scanning-for-secrets** | 代码安全扫描（9 种 Token 模式 + Pre-commit Hook） |
+| **understand-anything** | 交互式代码知识图谱（将代码库转为可探索的知识图谱） |
+
+## 安装
+
+```bash
+# 按 tag 批量安装所有 dev-workflow 相关 skill
+./install-by-tag.sh dev-workflow --system
+
+# 安装到特定 Agent
+./install-by-tag.sh dev-workflow --system --agent claude-code
+
+# 手动符号链接
+ln -s $(pwd)/dev/git-workflow ~/.claude/skills/git-workflow
+```
 
 

docs/Agents.md

@@ -1,6 +1,6 @@
 # 支持的 AI Agent 工具
 
-本文档介绍 Spark Skills 仓库支持的 AI Agent 工具及其配置方式。
+本文档介绍 Fire Skills 仓库支持的 AI Agent 工具及其配置方式。
 
 ## 支持的 Agent 列表
 
@@ -45,7 +45,7 @@ npx @z_ai/coding-helper
 
 **Skills 安装**：
 ```bash
-./install.sh claude-code
+./install-by-tag.sh dev-workflow --system --agent claude-code
 ```
 
 **模型映射**：
@@ -112,7 +112,7 @@ wire_api = "chat"
 
 **Skills 安装**：
 ```bash
-./install.sh codex
+./install-by-tag.sh dev-workflow --system --agent codex
 ```
 
 ---
@@ -134,7 +134,7 @@ kimi login
 
 **Skills 安装**：
 ```bash
-./install.sh kimi
+./install-by-tag.sh dev-workflow --system --agent kimi
 ```
 
 ---
@@ -164,7 +164,7 @@ opencode
 
 **Skills 安装**：
 ```bash
-./install.sh opencode
+./install-by-tag.sh dev-workflow --system --agent opencode
 ```
 
 ---

docs/README.md

@@ -1,16 +1,19 @@
-# Spark Skills 文档
+# Fire Skills 文档
 
-欢迎来到 Spark Skills 文档中心。本目录包含项目相关的详细文档和指南。
+欢迎来到 Fire Skills 文档中心。本目录包含项目相关的详细文档和指南。
 
 ## 文档索引
 
 ### 核心文档
 
 | 文档 | 说明 |
 |------|------|
+| [index.md](./index.md) | 文档首页（含快速开始和技能分类） |
 | [Agents.md](./Agents.md) | 支持的 AI Agent 工具介绍和配置说明 |
 | [ai-coding-tools-guide.md](./ai-coding-tools-guide.md) | AI 编程工具配置指南（Claude Code、Codex、OpenCode、GLM） |
-| [usage/install-frontend-skills.md](./usage/install-frontend-skills.md) | 前端技能安装指南（Web + 桌面应用） |
+| [usage/install-by-tag.md](./usage/install-by-tag.md) | 按 Tag 批量安装 Skills 指南 |
+| [usage/install-frontend-skills.md](./usage/install-frontend-skills.md) | 前端技能安装指南 |
+| [usage/fe-skills-reference-guide.md](./usage/fe-skills-reference-guide.md) | 前端技能参考指南 |
 
 ### 规范文档
 
@@ -19,6 +22,9 @@
 | [spec/auto-doc-update-proposal.md](./spec/auto-doc-update-proposal.md) | 任务完成后自动文档更新方案设计 |
 | [spec/ai-agent-protocol.md](./spec/ai-agent-protocol.md) | AI Agent 通用协议定义 |
 | [spec/agent-communication-protocols.md](./spec/agent-communication-protocols.md) | Agent 间通信协议 |
+| [spec/agent-output-template.md](./spec/agent-output-template.md) | Agent 输出模板规范 |
+| [spec/system-prompt-integration.md](./spec/system-prompt-integration.md) | System Prompt 集成方案 |
+| [validation/workflow-validation.md](./validation/workflow-validation.md) | 工作流验证文档 |
 
 ### 快速导航
 
@@ -40,7 +46,8 @@
 ## 项目主文档
 
 - [项目 README](../README.md) - 项目概览和快速开始
-- [SETUP.md](../SETUP.md) - 仓库构建过程文档
+- [安装脚本](../install-by-tag.sh) - 按 Tag 批量安装 Skills（macOS/Linux）
+- [清理脚本](../clean-skills.sh) - 清理已安装 Skills
 
 ## 贡献文档