@zhouhao4221/devflow-skills 0.3.4 → 0.3.7

package/README.md

@@ -6,16 +6,16 @@ DevFlow 技能包 —— 80 个 AI 技能指令，一键安装到 7 种 AI 工
 
 ```bash
 # 安装全部技能
-npx devflow-skills install --tool opencode --all
+npx @zhouhao4221/devflow-skills install --tool opencode --all
 
 # 安装指定插件
-npx devflow-skills install --tool cursor --plugin req
+npx @zhouhao4221/devflow-skills install --tool cursor --plugin req
 
 # 安装单个技能
-npx devflow-skills install --tool claude --skill req-dev
+npx @zhouhao4221/devflow-skills install --tool claude --skill req-dev
 
 # 查看所有技能
-npx devflow-skills list
+npx @zhouhao4221/devflow-skills list
 ```
 
 首次运行 `npx` 即用，无需安装任何依赖。
@@ -39,7 +39,7 @@ Claude Code 使用分层目录保留插件作用域；其余工具采用 `插件
 ### install — 安装技能
 
 ```bash
-npx devflow-skills install --tool <工具名> [--all | --plugin <插件> | --skill <名>] [--dir <路径>] [-g] [--symlink]
+npx @zhouhao4221/devflow-skills install --tool <工具名> [--all | --plugin <插件> | --skill <名>] [--dir <路径>] [-g] [--symlink]
 ```
 
 | 参数 | 说明 |
@@ -55,20 +55,20 @@ npx devflow-skills install --tool <工具名> [--all | --plugin <插件> | --ski
 ### list — 列出技能
 
 ```bash
-npx devflow-skills list [--plugin <插件>] [--filter <关键词>] [--format json]
+npx @zhouhao4221/devflow-skills list [--plugin <插件>] [--filter <关键词>] [--format json]
 ```
 
 ### uninstall — 卸载技能
 
 ```bash
-npx devflow-skills uninstall --tool <工具名> [--all | --skill <名>] [--dir <路径>] [-g]
+npx @zhouhao4221/devflow-skills uninstall --tool <工具名> [--all | --skill <名>] [--dir <路径>] [-g]
 ```
 
 ### add — 从 GitHub 仓库安装
 
 ```bash
-npx devflow-skills add <owner/repo> --list              # 浏览仓库中的技能
-npx devflow-skills add <owner/repo> --tool cursor --all  # 安装全部
+npx @zhouhao4221/devflow-skills add <owner/repo> --list              # 浏览仓库中的技能
+npx @zhouhao4221/devflow-skills add <owner/repo> --tool cursor --all  # 安装全部
 ```
 
 ## 技能分类
@@ -83,7 +83,7 @@ npx devflow-skills add <owner/repo> --tool cursor --all  # 安装全部
 
 ## 与 devflow-claude 的关系
 
-本仓库的技能源自 [devflow-claude](https://github.com/zhouhao4221/devflow-claude)（Claude Code 专属插件），独立出来作为跨工具的技能分发中心。devflow-claude 通过 `scripts/setup-claude.sh` 同步本仓库的技能文件，保持两边一致。
+本仓库是技能的唯一事实来源，[devflow-claude](https://github.com/zhouhao4221/devflow-claude)（Claude Code 专属插件）通过 `scripts/setup-claude.sh` 从此仓库同步技能文件。
 
 ## 手动安装（适配器脚本）
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhouhao4221/devflow-skills",
-  "version": "0.3.4",
+  "version": "0.3.7",
   "description": "一键安装/管理 devflow-skills AI 技能包",
   "license": "Apache-2.0",
   "repository": {

package/plugins/diag/templates/services.yaml.template

@@ -0,0 +1,31 @@
+# services.yaml - Diag 插件服务清单
+# 位置：~/.claude-diag/config/services.yaml
+#
+# 本文件是 **唯一** 的主机白名单源：
+# - SSH 目标主机必须在本文件 host 字段中登记，否则 Hook 直接拒绝
+# - 每次 /diag:diagnose 都会从本文件读取服务列表让用户选择
+#
+# 校验规则：
+# - 每个 service 必填 name / host / log_paths
+# - name 必须唯一（作为服务标识）
+# - host 对应 ~/.ssh/config 中的 Host 名，或 user@ip 形式
+# - log_paths 至少 1 条，绝对路径
+# - language_hint 可选，枚举：java / node / python / go / ruby / php（仅作 AI 识别提示）
+# - tags 可选，用于筛选
+
+services:
+  # ------ 示例条目（修改为真实服务后保留并增删） ------
+  - name: example-api
+    host: example-prod-01
+    log_paths:
+      - /var/log/app/example.log
+    language_hint: java
+    tags: [backend]
+
+  # - name: user-service
+  #   host: example-prod-02
+  #   log_paths:
+  #     - /var/log/user-service/app.log
+  #     - /var/log/user-service/error.log
+  #   language_hint: node
+  #   tags: [backend, user]

package/plugins/req/skills/branch/SKILL.md

@@ -7,9 +7,7 @@ description: 分支管理 - 配置分支策略、查看分支状态、创建紧
 
 管理项目的 Git 分支策略，与需求流程（dev/commit/done）联动。
 
-> **Audience:** Engineer
-> 此命令**不受仓库角色限制**，readonly 仓库也可执行。
-> 不触发缓存同步。
+> 不受仓库角色限制，readonly 可执行。不触发缓存同步。
 
 ## 命令格式
 
@@ -17,427 +15,100 @@ description: 分支管理 - 配置分支策略、查看分支状态、创建紧
 /req:branch [子命令] [参数]
 ```
 
-**子命令：**
-- `/req:branch` — 无子命令时等同于 `status`
-- `/req:branch init` — 交互式配置分支策略
-- `/req:branch status` — 查看当前策略和分支状态
-- `/req:branch hotfix [描述]` — 从主分支创建紧急修复分支
+| 子命令 | 说明 |
+|--------|------|
+| (空) | 等同于 `status` |
+| `init` | 交互式配置分支策略 |
+| `status` | 查看当前策略和分支状态 |
+| `hotfix [描述]` | 从主分支创建紧急修复分支 |
 
 ---
 
-## 子命令：init
+## init
 
-交互式选择分支策略，写入 `.claude/settings.json`（`giteaToken` 除外，写入 `settings.local.json`）。
+交互式选择分支策略。
 
-### 执行流程
+> 写入规范：读取已有 `.claude/settings.json`，合并 `branchStrategy` 字段后写回。`giteaToken` 写入 `.claude/settings.local.json`。
 
-#### 1. 选择策略模型
+### 流程
 
-```
-选择分支管理策略：
-
-  1. GitHub Flow（推荐）
-     所有分支从 main 拉，合回 main
-     适合：持续部署、Web 应用、中小团队
+**1. 选择策略模型**：GitHub Flow（推荐）/ Git Flow / Trunk-Based。三种策略的默认配置差异见 `branchStrategy` 字段：`model`、`mainBranch`、`developBranch`、`branchFrom`、`mergeTarget` 等。
 
-  2. Git Flow
-     功能分支从 develop 拉，合回 develop
-     适合：版本发布制、APP、大型项目
+**2. 确认或自定义**：生成默认配置展示给用户确认，可调整各项参数。
 
-  3. Trunk-Based
-     短期分支或直接在 main 开发
-     适合：成熟团队、高频发布、完善的 CI/CD
+**3. 自动检测主分支**：从 `origin/HEAD` 检测，不存在时按序探测 `main`/`master`。与默认值不同时自动更新。
 
-请选择（1/2/3）：
-```
+**4. 选择仓库类型**：GitHub (`gh` CLI) / Gitea (REST API) / 其他（仅展示命令）。Gitea 需额外输入实例 URL 和 API Token。
 
-#### 2. 确认或自定义配置
-
-根据选择生成默认配置，展示给用户确认：
-
-**GitHub Flow 默认配置（写入 `settings.json`）：**
-```json
-{
-  "branchStrategy": {
-    "model": "github-flow",
-    "repoType": "github",
-    "giteaUrl": null,
-    "mainBranch": "main",
-    "developBranch": null,
-    "featurePrefix": "feat/",
-    "fixPrefix": "fix/",
-    "hotfixPrefix": "hotfix/",
-    "branchFrom": "main",
-    "mergeTarget": "main",
-    "mergeMethod": "merge",
-    "deleteBranchAfterMerge": true,
-    "reviewers": []
-  }
-}
-```
+**5. 配置默认审核人**：逗号分隔的用户名，写入 `reviewers` 数组。留空则不设置。`/req:pr` 创建时自动请求审核。
 
-**Git Flow 默认配置（写入 `settings.json`）：**
-```json
-{
-  "branchStrategy": {
-    "model": "git-flow",
-    "repoType": "github",
-    "giteaUrl": null,
-    "mainBranch": "main",
-    "developBranch": "develop",
-    "featurePrefix": "feat/",
-    "fixPrefix": "fix/",
-    "hotfixPrefix": "hotfix/",
-    "branchFrom": "develop",
-    "mergeTarget": "develop",
-    "mergeMethod": "merge",
-    "deleteBranchAfterMerge": true,
-    "reviewers": []
-  }
-}
-```
-
-**Trunk-Based 默认配置（写入 `settings.json`）：**
-```json
-{
-  "branchStrategy": {
-    "model": "trunk-based",
-    "repoType": "github",
-    "giteaUrl": null,
-    "mainBranch": "main",
-    "developBranch": null,
-    "featurePrefix": "feat/",
-    "fixPrefix": "fix/",
-    "hotfixPrefix": "hotfix/",
-    "branchFrom": "main",
-    "mergeTarget": "main",
-    "deleteBranchAfterMerge": true,
-    "reviewers": []
-  }
-}
-```
+**6. Git Flow 额外步骤**：检查 develop 分支，不存在则从 main 创建。
 
-#### 3. 自动检测主分支名
-
-初始化时从 `origin/HEAD` 检测实际主分支名，不存在时按序探测 `main` / `master`。检测到的主分支与默认值不同时，自动更新配置：
-```
-检测到主分支为 master，已自动更新配置
-```
-
-#### 4. 选择仓库托管类型
-
-```
-仓库托管类型：
-
-  1. GitHub
-     使用 gh CLI 创建 PR
-
-  2. Gitea
-     使用 Gitea REST API 创建 PR
-
-  3. 其他（GitLab / Bitbucket / 本地）
-     仅展示合并命令，不自动创建 PR
-
-请选择（1/2/3，默认 1）：
-```
-
-**选择 Gitea 时追加配置：**
-
-```
-Gitea 实例地址（如 https://git.example.com）：
-```
-
-自动从 git remote URL 解析 owner/repo（SSH/HTTPS 均支持）。
-
-**Gitea Token 说明：**
-```
-Gitea API Token：
-   token 存入 .claude/settings.local.json 的顶层 giteaToken 字段（不提交 git）
-   生成方式：Gitea → 设置 → 应用 → 生成令牌（需 repo 权限）
-```
-
-#### 5. 配置默认审核人（可选）
-
-```
-默认审核人（创建 PR 时自动设置，无需每次确认）：
-   多个用逗号分隔，留空则不设置（如：alice,bob）：
-```
-
-输入格式：
-- 单人：`alice`
-- 多人：`alice,bob,carol`
-- 留空回车 → `reviewers: []`，PR 创建时不附带审核人
-
-写入 `branchStrategy.reviewers`（数组）。用户名按平台规范：
-- GitHub：账号 username
-- Gitea：实例内 username
-
-> 不在此校验用户是否存在；`/req:pr` 创建 PR 时调用平台 API，单个无效用户会输出 ⚠️ 但不阻塞 PR。
-
-#### 6. Git Flow 额外步骤
-
-如果选择 Git Flow，检查 develop 分支是否存在于远端：存在 → 使用；
-- 不存在 → 提示创建：
-  ```
-  develop 分支不存在，是否从 main 创建？
-  ```
-
-#### 7. 写入配置
-
-> 写入规范见 [_storage.md](./_storage.md#settings-文件写入规范)。
-
-**`branchStrategy`（不含 token）写入 `.claude/settings.json`**：读取已有内容，合并 `branchStrategy` 字段后写回。
-
-**`giteaToken` 单独写入 `.claude/settings.local.json`**（顶层字段，非嵌套在 `branchStrategy` 内）：
-```json
-{ "giteaToken": "<用户输入的 token>" }
-```
-非 Gitea 仓库时跳过此步骤（无需写入）。
-
-⚠️ **禁止**创建独立的 `branchStrategy.json` 或其他文件。
-
-```
-✅ 分支策略已配置！
-
-策略：GitHub Flow
-仓库类型：Gitea（https://git.example.com）
-主分支：main
-功能分支：feat/REQ-XXX-slug（从 main 拉）
-修复分支：fix/QUICK-XXX-slug（从 main 拉）
-紧急修复：hotfix/xxx（从 main 拉）
-合并目标：main
-合并后删除分支：是
-默认审核人：@alice, @bob   ← reviewers 非空时输出，空数组不输出此行
-
-后续使用：
-- /req:dev 创建分支时会自动遵循此策略
-- /req:commit 会检查分支合规性
-- /req:done 会根据仓库类型自动创建 PR 或提示合并命令
-```
+**7. 写入配置**：输出策略摘要（模型、仓库类型、分支前缀、合并目标、审核人等）。
 
 ---
 
-## 子命令：status
-
-查看当前分支策略和各需求分支的状态。
-
-### 执行流程
+## status
 
-#### 1. 读取策略配置
+### 流程
 
-从 `.claude/settings.json` 读取 `branchStrategy`；若需要 `giteaToken`，再从 `.claude/settings.local.json` 读取顶层 `giteaToken` 字段。
-
-**未配置时：**
-```
-⚠️ 未配置分支策略，使用默认行为
-
-建议执行 /req:branch init 配置分支策略
-```
-
-#### 2. 展示策略信息
-
-```
-分支策略：GitHub Flow
-
-| 配置项 | 值 |
-|-------|-----|
-| 模型 | github-flow |
-| 仓库类型 | gitea（https://git.example.com）|
-| 主分支 | main |
-| 功能分支前缀 | feat/ |
-| 修复分支前缀 | fix/ |
-| 紧急修复前缀 | hotfix/ |
-| 拉取基准 | main |
-| 合并目标 | main |
-| 合并后删除 | 是 |
-| 默认审核人 | @alice, @bob（空数组显示 -） |
-```
-
-#### 3. 展示当前分支状态
-
-获取当前分支名并展示：
-```
-当前分支：feat/REQ-001-user-points
-```
-
-#### 4. 展示活跃需求的分支信息
-
-扫描活跃需求文档，提取 branch 字段：
-
-```
-需求分支状态：
-
-| 需求 | 分支 | 状态 | 是否当前 |
-|------|------|------|---------|
-| REQ-001 用户积分 | feat/REQ-001-user-points | 开发中 | ← 当前 |
-| QUICK-002 修复过滤 | fix/QUICK-002-order-filter | 开发中 | |
-| REQ-003 订单管理 | - (未创建) | 评审通过 | |
-```
-
-#### 5. 检查分支健康状况
-
-```
-✅ 分支健康检查：
-- 当前在需求分支，关联 REQ-001 
-- 需求分支与主分支无冲突 
-```
-
-或：
-
-```
-⚠️ 分支注意事项：
-- 当前在 main 分支，有 2 个活跃需求分支
-- feat/REQ-001-user-points 落后 main 3 个提交，建议 rebase
-```
+1. 读取配置（未配置时提示建议执行 `init`）
+2. 展示策略信息表
+3. 展示当前分支
+4. 扫描活跃需求文档，展示各需求分支状态和是否当前
+5. 检查分支健康（当前是否在需求分支、与主分支是否有冲突、是否需要 rebase）
 
 ---
 
-## 子命令：hotfix
-
-从主分支创建紧急修复分支，用于线上紧急问题。
+## hotfix
 
-### 执行流程
+从主分支创建紧急修复分支。
 
-#### 1. 工作区检查
+### 流程
 
-有未提交改动时终止，提示先 commit 或 stash。
-
-#### 2. 收集信息
-
-如果未提供描述，询问用户：
-- 问题描述（必填）
-
-#### 3. 生成分支名
-
-```
-hotfix/<slug>
-```
-
-- slug：问题描述的英文翻译，lowercase kebab-case，最多 5 词
-
-#### 4. 创建分支
-
-**关键**：hotfix 始终从**主分支**拉取，无论当前使用什么策略。
-
-fetch 并基于 `branchStrategy.mainBranch`（默认 main）创建 `hotfix/<slug>` 分支。
-
-```
-紧急修复分支已创建
-
-分支：hotfix/fix-order-total-calc
-基于：main (最新)
-完成后合并到：main
-
-后续步骤：
-1. 修复问题
-2. /req:commit 修复订单金额计算错误
-3. 合并到 main：git checkout main && git merge hotfix/fix-order-total-calc
-4. 删除分支：git branch -d hotfix/fix-order-total-calc
-```
-
-#### 5. Git Flow 额外提醒
-
-如果使用 Git Flow 策略，hotfix 完成后需要合并到**两个分支**：
-
-```
-完成后需合并到：
-1. main（生产环境）
-2. develop（开发分支同步）
-
-合并命令：
-git checkout main && git merge hotfix/fix-order-total-calc
-git checkout develop && git merge hotfix/fix-order-total-calc
-git branch -d hotfix/fix-order-total-calc
-```
+1. 工作区检查（有未提交改动则终止）
+2. 收集问题描述（必填）
+3. 生成分支名 `hotfix/<slug>`（slug：英文翻译，kebab-case，最多 5 词）
+4. 基于 `branchStrategy.mainBranch` 创建分支
+5. **Git Flow 额外提醒**：hotfix 完成后需合并到 main 和 develop 两个分支
 
 ---
 
 ## 策略对各命令的影响
 
-### /req:dev 分支创建
+### `/req:dev` 分支创建
 
-| 配置项 | 影响 |
-|-------|------|
-| `branchFrom` | `git checkout -b <branch> <branchFrom>` 的基准分支 |
-| `featurePrefix` | REQ-XXX 分支前缀（替代硬编码的 `feat/`） |
-| `fixPrefix` | QUICK-XXX 分支前缀（替代硬编码的 `fix/`） |
+`branchFrom` 决定基准分支，`featurePrefix`/`fixPrefix` 决定分支前缀。
 
-### /req:commit 分支检查
+### `/req:commit` 分支检查
 
 | 场景 | 行为 |
 |------|------|
-| 在 mainBranch 上，有活跃需求 | ⚠️ 警告并建议切换到需求分支 |
-| 在 mainBranch 上，无活跃需求 | 正常提交 |
-| 在 developBranch 上（Git Flow） | ⚠️ 警告，功能开发应在功能分支 |
-| 在需求分支上 | 正常提交，自动关联对应需求 |
-| 在 hotfix 分支上 | 正常提交，类型建议选「修复」 |
-
-### /req:pr 审核人自动设置
+| 在 mainBranch 上，有活跃需求 | 警告建议切换 |
+| 在 developBranch 上（Git Flow） | 警告应在功能分支 |
+| 在需求/hotfix 分支上 | 正常提交 |
 
-| 配置项 | 影响 |
-|-------|------|
-| `reviewers` | 非空时创建 PR 后自动请求审核（GitHub: `gh pr create --reviewer ...`；Gitea: `POST /pulls/<N>/requested_reviewers`），不再询问用户 |
+### `/req:pr` 审核人
 
-### /req:done 合并方式
+`reviewers` 非空时创建 PR 后自动请求审核，不询问用户。
 
-根据 `repoType` 决定合并方式：
+### `/req:done` 合并方式
 
 | 仓库类型 | 行为 |
 |---------|------|
-| `gitea` | 自动推送分支 + 调用 Gitea API 创建 PR |
-| `github` | 提示使用 `gh pr create` 命令 |
-| `other` | 仅展示 `git merge` 合并命令 |
+| `gitea` | 推送 + API 创建 PR |
+| `github` | 提示 `gh pr create` |
+| `other` | 展示 `git merge` 命令 |
 
-合并目标根据策略决定：
-
-| 策略 | 合并目标 |
-|------|---------|
-| GitHub Flow | `main` |
-| Git Flow | `develop`（hotfix 额外合并到 main） |
-| Trunk-Based | `main` |
+合并目标：GitHub Flow → `main`，Git Flow → `develop`（hotfix 额外 → main），Trunk-Based → `main`。
 
 ---
 
 ## 配置兼容性
 
-### 未配置策略时的行为
-
-所有命令保持当前默认行为，不会报错：
-- `/req:dev`：使用硬编码的 `feat/` 和 `fix/` 前缀，自动检测主分支
-- `/req:commit`：不做分支检查
-- `/req:done`：通用合并提醒
-
-### 配置存储
-
-```jsonc
-// .claude/settings.json（纳入 git，团队共享）
-{
-  "requirementProject": "my-saas",
-  "requirementRole": "primary",
-  "branchStrategy": {
-    "model": "github-flow",
-    "repoType": "gitea",
-    "giteaUrl": "https://git.example.com",
-    "mainBranch": "main",
-    "developBranch": null,
-    "featurePrefix": "feat/",
-    "fixPrefix": "fix/",
-    "hotfixPrefix": "hotfix/",
-    "branchFrom": "main",
-    "mergeTarget": "main",
-    "mergeMethod": "merge",
-    "deleteBranchAfterMerge": true,
-    "reviewers": ["alice", "bob"]
-  }
-}
-```
+未配置策略时所有命令保持默认行为（`feat/`/`fix/` 前缀，不做分支检查，通用合并提醒），不会报错。
 
-```jsonc
-// .claude/settings.local.json（本地，加入 .gitignore，不提交）
-{
-  "giteaToken": "YOUR_TOKEN_HERE"
-}
-```
+配置文件结构见 `.claude/settings.json`（`branchStrategy` 对象，纳入 git）和 `.claude/settings.local.json`（`giteaToken`，不提交）。
 
 ---
 

package/plugins/req/skills/dev/SKILL.md

@@ -8,7 +8,7 @@ description: 需求开发 - 启动或继续开发
 启动或继续需求开发，先生成实现方案，确认后逐步实现。
 
 > **Audience:** Engineer
-> 存储路径规则见 [_storage.md](./_storage.md)
+> 存储路径规则见 `_storage.md`
 
 ## 命令格式