abelworkflow 0.1.0 → 0.2.0

package/.gitignore

@@ -11,3 +11,5 @@ skills/dev-browser/tmp/
 */build/
 .claude/
 .codex/
+*pycache*/
+.codex

package/README.md

@@ -60,24 +60,67 @@ Codex、OpenCode、Claude Code 的 Skills 和 Commands 配置仓库。
 
 ## 安装与更新
 
-### 推荐：`npx` 一键安装
+### 方法一：npx 一键安装（推荐）
 
 ```bash
-# 安装到 ~/.agents，并自动完成 ~/.claude / ~/.codex 的链接
+# 交互式初始化菜单
 npx abelworkflow
 
+# 直接执行工作流同步/重链
+npx abelworkflow install
+
 # 更新到最新发布版本
 npx abelworkflow@latest
 ```
 
 > 说明：
 > - npm 发布包名必须使用小写，所以实际可执行命令是 `npx abelworkflow`。
-> - 仓库显示名可以继续叫 `AbelWorkflow`，但不建议承诺 `npx AbelWorkflow`，这不符合 npm 当前命名规则。
-> - 一键安装会把仓库内容同步到 `~/.agents`，并自动建立下文 README 中的链接关系，无需再手动执行 `ln -s`。
+> - 交互式模式下，默认会打开初始化菜单，支持：
+>   - 同步 `~/.agents` 并自动重建 `~/.claude` / `~/.codex` 链接
+>   - 交互式填写 `grok-search`、`context7-auto-research`、`prompt-enhancer` 的 `.env`
+>   - 一键安装或更新 `Claude Code`、`Codex`
+>   - 配置 `Claude Code` 的第三方 API 到 `~/.claude/settings.json`
+>   - 配置 `Codex` 的第三方 API 到 `~/.codex/config.toml` 和 `~/.codex/auth.json`
+> - 非交互场景请显式使用 `npx abelworkflow install`，不再保留旧的默认自动同步逻辑。
 
-### 备用：Git 克隆安装
+### 交互式初始化能力
 
-### Linux/macOS（bash/zsh）
+`npx abelworkflow` 现在默认提供一个类似 `npx zcf` 的菜单，常见入口包括：
+
+```bash
+npx abelworkflow
+npx abelworkflow init
+npx abelworkflow install
+npx abelworkflow --help
+```
+
+其中完整初始化会按需引导你完成：
+
+1. 安装 AbelWorkflow 到 `~/.agents`
+2. 自动链接到 `~/.claude/` 和 `~/.codex/`
+3. 可选安装 `Claude Code` CLI
+4. 可选配置 `Claude Code` 第三方 API
+5. 可选安装 `Codex` CLI
+6. 可选配置 `Codex` 第三方 API
+7. 可选填写三个技能的环境变量
+
+### 技能环境写入位置
+
+交互式配置会把技能密钥写到 `~/.agents` 下对应 skill 目录的 `.env` 中：
+
+| 技能 | 写入位置 | 主要字段 |
+|---|---|---|
+| `grok-search` | `~/.agents/skills/grok-search/.env` | `GROK_API_URL` `GROK_API_KEY` `GROK_MODEL` |
+| `context7-auto-research` | `~/.agents/skills/context7-auto-research/.env` | `CONTEXT7_API_KEY` |
+| `prompt-enhancer` | `~/.agents/skills/prompt-enhancer/.env` | `ANTHROPIC_API_KEY` / `OPENAI_API_KEY` `PE_MODEL` |
+
+### 方法二：源码克隆安装
+
+如需自定义修改或贡献代码，可手动克隆后直接运行本地 CLI：
+
+#### 1. 克隆仓库
+
+**Linux/macOS（bash/zsh）**
 
 ```bash
 # 首次安装
@@ -87,7 +130,7 @@ git clone https://github.com/abelxiaoxing/AbelWorkflow ~/.agents
 git -C ~/.agents pull
 ```
 
-### Windows（PowerShell）
+**Windows（PowerShell）**
 
 ```powershell
 # 首次安装
@@ -97,9 +140,19 @@ git clone https://github.com/abelxiaoxing/AbelWorkflow "$HOME\.agents"
 git -C "$HOME\.agents" pull
 ```
 
-## 链接到 Claude Code / Codex（`npx` 会自动完成）
+#### 2. 执行本地初始化
+
+```bash
+cd ~/.agents
+node bin/abelworkflow.mjs
+```
+
+如果只想重建链接，不进入菜单：
 
-> 目标：把本仓库作为「单一来源」，通过符号链接同步到 `~/.claude/` 和 `~/.codex/`。以后只需 `git -C ~/.agents pull`，两边配置会自动更新。
+```bash
+cd ~/.agents
+node bin/abelworkflow.mjs install
+```
 
 ### 映射关系（本仓库 → 配置目录）
 
@@ -109,39 +162,11 @@ git -C "$HOME\.agents" pull
 | `skills/<skill>/` | `~/.claude/skills/<skill>/` | `~/.codex/skills/<skill>/` | Skills（每个目录一个技能） |
 | `commands/oc/` | `~/.claude/commands/oc/` | `~/.codex/prompts/*.md` | Claude 读 `commands/`；Codex 读 `prompts/` |
 
-### Linux/macOS（bash/zsh）
-
-```bash
-AGENTS_DIR="$HOME/.agents"
-
-# Claude Code
-mkdir -p "$HOME/.claude/commands" "$HOME/.claude/skills"
-ln -s "$AGENTS_DIR/AGENTS.md" "$HOME/.claude/CLAUDE.md"
-ln -s "$AGENTS_DIR/commands/oc" "$HOME/.claude/commands/oc"
-for d in "$AGENTS_DIR/skills/"*; do
-  [ -d "$d" ] && ln -s "$d" "$HOME/.claude/skills/"
-done
-
-# Codex
-mkdir -p "$HOME/.codex/skills" "$HOME/.codex/prompts"
-ln -s "$AGENTS_DIR/AGENTS.md" "$HOME/.codex/AGENTS.md"
-for d in "$AGENTS_DIR/skills/"*; do
-  [ -d "$d" ] && ln -s "$d" "$HOME/.codex/skills/"
-done
-ln -s "$AGENTS_DIR/commands/oc/init.md" "$HOME/.codex/prompts/init.md"
-ln -s "$AGENTS_DIR/commands/oc/research.md" "$HOME/.codex/prompts/research.md"
-ln -s "$AGENTS_DIR/commands/oc/plan.md" "$HOME/.codex/prompts/plan.md"
-ln -s "$AGENTS_DIR/commands/oc/implementation.md" "$HOME/.codex/prompts/implementation.md"
-ln -s "$AGENTS_DIR/commands/oc/diagnose.md" "$HOME/.codex/prompts/diagnose.md"
-```
-
-> 提示：
-> - 如果提示 `File exists`，说明目标路径已存在：先备份/删除原文件（例如 `mv ~/.claude/CLAUDE.md ~/.claude/CLAUDE.md.bak`），再重新执行 `ln -s`。
-> - 不建议把整个 `skills/` 目录直接链接成 `~/.codex/skills`，否则可能遮住 Codex 自带的 `~/.codex/skills/.system/`。
-
 ### 验证（可选）
 
 ```bash
 ls -la "$HOME/.claude/CLAUDE.md" "$HOME/.claude/commands/oc"
 ls -la "$HOME/.codex/AGENTS.md" "$HOME/.codex/prompts/"{init,research,plan,implementation,diagnose}.md
+cat "$HOME/.claude/settings.json" | head
+cat "$HOME/.codex/config.toml" | head
 ```