@vima_tech/flywheel 1.0.0 → 1.1.1

package/install.sh

@@ -1,194 +0,0 @@
-#!/bin/bash
-# Flywheel — 自成长 AI Agent 飞轮框架
-#
-# 一键安装（GitHub 下载方式）：
-#   curl -sSL https://raw.githubusercontent.com/renmengkai/flywheel/main/install.sh | bash
-#
-# 一键安装（npm 方式）：
-#   npm install -g @vima_tech/flywheel
-#
-# 安装并指定 skill（仅限 GitHub 方式）：
-#   curl -sSL https://raw.githubusercontent.com/renmengkai/flywheel/main/install.sh | bash -s req-mining
-
-set -e
-
-REPO="renmengkai/flywheel"
-BRANCH="main"
-BASE_URL="https://raw.githubusercontent.com/$REPO/$BRANCH"
-INSTALL_DIR="${FLYWHEEL_DIR:-.}"
-SKILLS=()
-
-# ── 解析参数 ───────────────────────────────────────────────────
-for arg in "$@"; do
-  case "$arg" in
-    --list)
-      echo "可用 skill 包（通过 PR 添加更多）："
-      echo "  req-mining   需求挖掘与落地（内置）"
-      exit 0
-      ;;
-    --help|-h)
-      echo "用法：curl -sSL .../install.sh | bash -s [skill-name...]"
-      echo "      bash install.sh [--list] [skill-name...]"
-      exit 0
-      ;;
-    *) SKILLS+=("$arg") ;;
-  esac
-done
-
-[ ${#SKILLS[@]} -eq 0 ] && SKILLS=("req-mining")
-
-# ── 环境检查 ───────────────────────────────────────────────────
-check_deps() {
-  local missing=()
-  command -v curl    &>/dev/null || missing+=("curl")
-  command -v git     &>/dev/null || missing+=("git")
-  command -v python3 &>/dev/null || missing+=("python3")
-  if [ ${#missing[@]} -gt 0 ]; then
-    echo "❌ 缺少依赖：${missing[*]}"
-    echo "   请先安装后重试"
-    exit 1
-  fi
-}
-
-# ── 文件下载工具 ───────────────────────────────────────────────
-download() {
-  local src="$1"   # 相对于仓库根的路径
-  local dst="$2"   # 目标路径（相对于 INSTALL_DIR）
-  local full_dst="$INSTALL_DIR/$dst"
-  mkdir -p "$(dirname "$full_dst")"
-  curl -fsSL "$BASE_URL/$src" -o "$full_dst"
-}
-
-# ── 下载内核文件 ───────────────────────────────────────────────
-install_kernel() {
-  echo "📦 安装 Flywheel 内核..."
-
-  local kernel_files=(
-    "CLAUDE.md"
-    ".gitignore"
-    ".claude/commands/flywheel.md"
-    ".claude/commands/skill.md"
-    "scripts/auto-distill.sh"
-    "scripts/feedback-hook.sh"
-    "scripts/bridge-to-coder.sh"
-    "scripts/flywheel-install.sh"
-    "templates/state.json"
-    "skills/_kernel/distillation.md"
-    "skills/_template/skill.yaml"
-    "skills/_template/domain.md"
-    "skills/_template/feedback-questions.sh"
-  )
-
-  for f in "${kernel_files[@]}"; do
-    download "$f" "$f"
-    echo "  ✓ $f"
-  done
-
-  # 初始化运行时目录（gitignore 内容）
-  mkdir -p "$INSTALL_DIR"/{.distill-needed,episodic-logs,projects,memory}
-  touch "$INSTALL_DIR/.distill-needed/.gitkeep"
-  touch "$INSTALL_DIR/episodic-logs/.gitkeep"
-  touch "$INSTALL_DIR/projects/.gitkeep"
-  touch "$INSTALL_DIR/memory/.gitkeep"
-
-  chmod +x "$INSTALL_DIR"/scripts/*.sh
-  echo "  ✓ 内核安装完成"
-}
-
-# ── 下载 skill 包 ──────────────────────────────────────────────
-install_skill() {
-  local skill="$1"
-  echo ""
-  echo "🎯 安装 skill：$skill"
-
-  # 读取 skill.yaml 获取文件列表
-  local yaml_url="$BASE_URL/skills/$skill/skill.yaml"
-  if ! curl -fsSL "$yaml_url" -o /dev/null 2>/dev/null; then
-    echo "  ❌ skill '$skill' 不存在，可用列表：bash install.sh --list"
-    return 1
-  fi
-
-  # 下载核心文件
-  local skill_files=(
-    "skills/$skill/skill.yaml"
-    "skills/$skill/domain.md"
-    "skills/$skill/feedback-questions.sh"
-  )
-
-  # 可选文件（不存在则跳过）
-  local optional_files=(
-    "skills/$skill/artifacts.md"
-    "skills/$skill/bridge.sh"
-    "skills/$skill/memory/failure-patterns.md"
-    "skills/$skill/industry/erp.md"
-  )
-
-  for f in "${skill_files[@]}"; do
-    download "$f" "$f" && echo "  ✓ $f" || echo "  ⚠ 跳过 $f"
-  done
-
-  for f in "${optional_files[@]}"; do
-    curl -fsSL "$BASE_URL/$f" -o "$INSTALL_DIR/$f" 2>/dev/null \
-      && echo "  ✓ $f" \
-      || true  # 可选文件不报错
-  done
-
-  echo "  ✓ skill '$skill' 安装完成"
-}
-
-# ── 更新 .gitignore ────────────────────────────────────────────
-setup_gitignore() {
-  local marker="# flywheel-managed"
-  local gitignore="$INSTALL_DIR/.gitignore"
-
-  # 如果已经有 flywheel 标记则跳过
-  grep -q "$marker" "$gitignore" 2>/dev/null && return
-
-  cat >> "$gitignore" << 'EOF'
-
-# flywheel-managed
-projects/*/
-episodic-logs/
-.distill-needed/*
-!.distill-needed/.gitkeep
-memory/.gitkeep
-*.log
-EOF
-  echo "  ✓ .gitignore 已更新"
-}
-
-# ── 主流程 ─────────────────────────────────────────────────────
-main() {
-  echo ""
-  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-  echo "   Flywheel 安装器 v1.0"
-  echo "   自成长 AI Agent 飞轮框架"
-  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-  echo ""
-  echo "安装目录：$(realpath "$INSTALL_DIR")"
-  echo "Skills：${SKILLS[*]}"
-  echo ""
-
-  check_deps
-  install_kernel
-  setup_gitignore
-
-  for skill in "${SKILLS[@]}"; do
-    install_skill "$skill"
-  done
-
-  echo ""
-  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-  echo "  ✅ 安装完成！"
-  echo ""
-  echo "  启动方式："
-  echo "    cd $(realpath "$INSTALL_DIR") && claude"
-  echo "    输入 /flywheel 或 sfw 激活飞轮"
-  echo ""
-  echo "  npm 安装用户可运行：flywheel list"
-  echo "  查看可用 skill：bash install.sh --list"
-  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-  echo ""
-}
-
-main

package/skills/req-mining/artifacts.md

@@ -1,185 +0,0 @@
----
-name: req-miner-artifacts
-skill_id: req_miner_artifacts
-version: 2.0
-description: >
-  需求挖掘产物生成规格。仅在阶段四退出条件全部满足后加载。
-  定义三份产物的完整结构：需求澄清报告 + AI 执行文档 + 可视化原型规格。
-is_required: false
-hard_dep: [req_miner_core]
-soft_dep: []
-estimated_tokens: 1000
----
-
-# 产物生成规格
-
-阶段四退出条件全部满足后，依次生成以下三份产物。
-**三份产物信息来源完全一致，出现不一致 = 需求对话有遗漏，必须修正后再输出。**
-
----
-
-## 输出前自检（必须执行，任一未通过则补充对话）
-
-```
-□ 业务流程是否完整？（销售/采购/库存/财务四条链条无断点）
-□ MoSCoW 是否明确区分 Must / Should / Won't？
-□ 是否有成本核算方法定义？
-□ 是否有应收应付账款管理？
-□ 是否有退货/售后流程？
-□ 是否有数据备份和导出策略？
-□ 验收标准是否包含性能指标（具体数字）？
-□ 验收标准是否包含安全/权限要求？
-□ Parking Lot 是否清零？
-```
-
----
-
-## 产物 1：需求澄清报告
-
-**面向：** 甲方决策人（人话描述，客户签字确认）
-
-```
-1. 项目背景
-   项目名称 | 调研时间 | 客户行业 | 核心目标用户
-
-2. 真实目标 vs 表达目标
-   甲方原话：[引用] → 真实目标：[澄清后] → 验证方式：[如何判断达成]
-
-3. 功能范围（MoSCoW）
-   Must Have（本期必须）：[列表]
-   Should Have（本期应该）：[列表]
-   Won't Have（本期不做，原因）：[列表]
-
-4. 使用角色与场景
-   角色：[角色名] | 使用频率 | 核心任务
-   场景：至少 2 个完整端到端场景描述
-
-5. 约束与边界
-   预算：[范围 + 决策链] | 时间：[期望上线 + 硬截止] | 部署：[方式]
-   技术：[已有系统/需对接/偏好] | 合规：[数据安全/等保要求]
-
-6. 业务流程完整性说明
-   [描述销售/采购/库存/财务完整链条，标注本期覆盖范围]
-
-7. 数据安全需求
-   权限模型 | 数据隔离级别 | 审计日志策略 | 合规要求
-
-8. 非功能性需求
-   性能（具体数字）| 可用性（SLA）| 备份策略 | 导出格式 | 打印需求
-
-9. 集成需求
-   [第三方系统] + [对接方式] + [数据格式]
-
-10. 隐含假设清单
-    [假设内容] → 已确认 / 待确认 / 存在风险
-
-11. Parking Lot（未解决问题）
-    [问题] | 风险级别 | 必须解决时间节点
-
-12. 落地风险评估
-    [风险描述] | 可能性 | 影响 | 建议处理方式
-
-13. 验收标准（≥5条，含功能性/非功能性/安全）
-    每条格式：[主语] + [操作] + [可测试结果]
-
-14. 本期明确不做的功能（显式列出，防止后期扯皮）
-
-15. 甲方确认签字栏
-    客户签字：____ | 分析师：____ | 日期：____
-```
-
----
-
-## 产物 2：AI 执行文档
-
-**面向：** 执行 AI（无歧义技术规格）
-**禁止出现：** 可能、也许、适当、合理、尽量、一般情况下
-
-```
-1. 系统概述
-   一段话：系统是什么，服务谁，核心特性，技术栈建议，部署架构
-
-2. 技术约束（必须是具体数字）
-   并发用户数 | 页面加载时间 | 数据量级 | 响应时间 | 可用性 SLA
-
-3. 权限模型（RBAC）
-   角色定义 | 权限矩阵 | 数据隔离级别 | API 鉴权方案 | 敏感操作二次确认清单
-
-4. 数据模型
-   每个实体：表名 | 字段名 | 类型 | 约束 | 索引 | 外键 | 枚举值定义
-
-5. 数据字典
-   所有枚举字段的完整取值定义（如订单状态、付款状态、角色类型）
-
-6. 功能规格（每个 Must Have 功能点）
-   触发条件 | 输入（字段+验证规则）| 处理逻辑（步骤，无歧义）| 输出 | 异常处理 | 边界情况
-
-7. 状态机定义
-   订单状态机 | 库存状态 | 支付状态（含每个状态的触发条件和转移规则）
-
-8. 安全设计
-   密码加密方案 | 传输加密 | SQL 注入防护 | XSS 防护 | 审计日志字段定义
-
-9. 数据库策略
-   索引设计 | 迁移策略 | 并发控制（乐观锁/悲观锁）| 备份方案
-
-10. 验收测试用例
-    每个功能点：正向用例 + 异常用例 + 边界用例
-
-11. 未覆盖情况处理规则
-    "遇到本文档未说明的情况，必须停止并记录，不得自行决定"
-    [列出已知高风险歧义场景及标准处理方式]
-
-12. 变更记录
-    版本 | 日期 | 变更内容 | 确认人
-```
-
----
-
-## 产物 3：可视化原型规格
-
-**按已锁定的保真度等级输出（A/B/C，不可更改）**
-
-**标注规范（所有等级通用）：**
-- 🔴 需要特别确认的业务逻辑
-- 🟡 存在不确定性，待甲方说明
-- 🟢 已确认，无需讨论
-- ⚪ 本期范围外
-
-**所有等级必须覆盖：**
-
-```
-□ 所有 Must Have 功能的页面/流程
-□ 每个页面的边界情况（空状态 / 加载状态 / 错误状态）
-□ 每个页面与验收标准的对应关系
-□ 订单/库存状态机可视化流转图
-□ 批量操作交互设计（批量导入/导出/修改）
-□ 导出功能 UI 入口（Excel/PDF 导出按钮位置和进度提示）
-```
-
-**A. 流程图额外要求：**
-- 页面节点 + 跳转逻辑 + 触发条件
-- 每个节点的关键字段列表（文字说明）
-
-**B. 线框图额外要求（在 A 基础上）：**
-- 完整字段标注（字段名、类型、是否必填）
-- 关键交互标注（点击跳转目标）
-- 打印样式设计（报价单/发票/出库单的打印布局）
-
-**C. 中保真额外要求（在 B 基础上）：**
-- 基本配色方案（与客户品牌相符）
-- 主要页面的视觉风格（字体、间距、卡片样式）
-- 关键操作按钮样式
-
----
-
-## 产物输出后操作
-
-```
-1. 更新 state.json → current_phase: "completed"
-2. 归档本次会话日志（追加到 episodic-logs/{project_id}.jsonl）
-3. 输出摘要：
-   "三份产物已生成。
-    本次对话：[N] 轮 | Parking Lot 解决：[N] 项 | 未覆盖决策：[N] 项
-    建议专家审查后发送给客户确认。"
-```

package/skills/req-mining/domain.md

@@ -1,243 +0,0 @@
----
-name: auto-req
-skill_id: auto_req
-version: 1.0
-description: >
-  自驱需求分析 Skill。无需人类实时对话，从输入文档（需求文档、邮件线程、
-  Jira tickets、会议记录）中自主运行四阶段框架，提取需求并生成三份产物。
-  是飞轮架构的 Ring 1 自驱化核心。
-is_required: false
-hard_dep: [req_miner_core]
-soft_dep: []
-estimated_tokens: 1200
-trigger_phrases:
-  - "分析这份文档"
-  - "从文档提取需求"
-  - "无对话模式"
-  - "自动分析"
-  - "headless模式"
-  - "批量需求"
----
-
-# 自驱需求分析协议
-
-**使用场景：** 客户已提供书面材料（需求文档、邮件、会议纪要、竞品截图），
-无法实时对话，但需要结构化需求产物。
-
-**与普通模式的区别：**
-- 普通模式：与人类实时对话提炼需求
-- 自驱模式：从文档推断需求，用 `⚠️ 假设` 标注所有不确定点，不阻塞流程
-
----
-
-## Step 0：接收输入材料
-
-用户提供以下任意格式：
-- 直接粘贴文本
-- 文件路径（读取内容）
-- URL（抓取内容）
-- 多份材料（合并分析）
-
-**确认输入后，询问项目基本信息（一次性询问）：**
-
-```
-已收到材料（约 XXX 字）。
-
-请确认以下信息（可全部省略，我会从文档推断）：
-1. 项目名称：
-2. 客户行业：
-3. 分析侧重点（功能 / 约束 / 验收标准）：
-4. 缺失信息处理方式：
-   A. 标注假设，继续分析（推荐）
-   B. 列出问题，等待补充后再分析
-```
-
----
-
-## Step 1：材料扫描与信息提取
-
-**读取所有材料，提取以下维度（静默执行，不逐条输出）：**
-
-```
-维度 1：业务目标信号
-  - 明确陈述的目标
-  - 隐含目标（从"痛点"、"现在的问题"、"希望"等词推断）
-  - 利益相关者提及的关键词
-
-维度 2：功能需求信号
-  - 动词短语（"能够"、"支持"、"允许"、"需要"）
-  - 角色 + 操作 + 对象 的句式
-  - 列表/表格中的功能点
-
-维度 3：约束信号
-  - 数字（预算、时间、用户量、性能指标）
-  - 技术栈提及
-  - 安全/合规要求
-  - "不能"、"禁止"、"限制"等否定约束
-
-维度 4：验收信号
-  - "验收"、"上线标准"、"测试"、"通过"等词周围的内容
-  - KPI、指标、可量化结果
-
-维度 5：矛盾信号
-  - 同一实体在不同位置有不同描述
-  - 需求数量与预算/时间明显不匹配
-  - 技术限制与功能要求相冲突
-```
-
----
-
-## Step 2：四维度分析输出
-
-**输出格式：**
-
-```
-━━━ 自驱分析结果 | 项目：{name} | 材料：{N}份 ━━━
-
-## 一、目标层
-
-真实目标（推断）：[描述]
-表达目标（材料原话）：[引用]
-推断依据：[关键词/段落]
-⚠️ 假设 A1：[不确定点]，假设为 [推断值]，如有误请纠正
-
-## 二、功能层
-
-Must Have（明确提及 ≥2 处或被标注为核心）：
-  • [功能1]（来源：[段落标识]）
-  • [功能2]
-
-Should Have（明确提及 1 处）：
-  • [功能3]
-
-⚠️ 假设 F1：材料中提及"[X功能]"但未说明优先级，暂归为 Should Have
-
-Won't Have（材料明确排除，或超出范围）：
-  • [功能4]（来源：[原话]）
-
-## 三、约束层
-
-预算：[数值或"未提及，⚠️ 假设 C1：按中型项目估算 10-30万"]
-时间：[数值或推断]
-部署方式：[私有化/SaaS/未知]
-用户规模：[数值或推断]
-技术约束：[列表]
-
-## 四、验收层
-
-明确验收标准：
-  • [标准1]（来源：[原话]）
-推断验收标准（从功能反推）：
-  • [标准2]（⚠️ 假设 V1：推断）
-
-## 五、矛盾与风险
-
-⚠️ 矛盾 M1：材料第3段说"[A]"，第7段说"[B]"，需确认
-🔴 高风险：[需求规模与时间/预算明显不匹配 等]
-
-## 六、信息缺口清单
-
-以下信息材料中无法推断，需人工确认：
-  □ [问题1]（影响：影响功能规格，阻塞产物2生成）
-  □ [问题2]（影响：影响验收标准定义）
-```
-
----
-
-## Step 3：生成方式选择
-
-**分析完成后，询问：**
-
-```
-━━━ 自驱分析完成 ━━━
-
-发现信息缺口 {N} 处，其中：
-- 阻塞级（必须确认才能输出）：{M} 处
-- 非阻塞级（可用假设替代）：{N-M} 处
-
-如何继续？
-A. 立即生成三份产物（用假设填充缺口，产物中标注⚠️）
-B. 先补充 {M} 处关键信息，再生成
-C. 导出信息缺口清单，人工填写后继续
-```
-
----
-
-## Step 4：生成三份产物
-
-收到用户选择后，加载 `skills/artifacts/req-miner-artifacts.md`，
-按规格生成三份产物。
-
-**自驱模式特殊标注规则：**
-
-- 所有通过推断而非明确确认的内容，加 `⚠️[假设:A1]` 标注
-- 产物首页增加"假设清单"章节，汇总所有假设
-- 验收标准中推断类标准，标注"待客户确认"
-
----
-
-## Step 5：写入状态与日志
-
-```python
-# 更新 state.json
-state["auto_req_mode"] = True
-state["assumptions_count"] = N
-state["info_gaps"] = [gap_list]
-state["artifacts_generated"] = True
-
-# 追加事件日志
-event = {
-    "event_id": "evt_auto_req_001",
-    "type": "auto_req_completed",
-    "assumptions_count": N,
-    "info_gap_blocking": M,
-    "distillation_candidate": True
-}
-```
-
----
-
-## Step 6：自动启动 Ring 2（飞轮衔接）
-
-产物写入完成后，**直接通过 Bash 工具调用桥接脚本**，无需用户手动执行：
-
-```bash
-./scripts/bridge-to-coder.sh {project_id} {tool}
-# tool 默认 claude；若用户指定了其他工具则使用用户指定的
-```
-
-输出提示：
-```
-━━━ Ring 1 完成，自动启动 Ring 2 ━━━
-正在调用：./scripts/bridge-to-coder.sh {project_id} {tool}
-编程工具退出后将自动收集反馈，满足条件时自动触发蒸馏
-```
-
-**注意：** bridge-to-coder.sh 会启动一个交互式编程工具会话（如 claude），
-此时当前 AI 会话暂时挂起，等待编程工具退出后继续。
-
----
-
-## 自驱模式与飞轮的配合
-
-```
-输入文档
-    │
-    ▼
-自驱分析（本 Skill）
-    │ 生成三份产物 + 假设清单
-    ▼
-bridge-to-coder.sh → 编程工具实现
-    │ 实现过程中确认/否定假设
-    ▼
-feedback-hook.sh → 写入假设验证结果
-    │ 哪些假设对了，哪些错了
-    ▼
-蒸馏 → 更新"自驱推断规则"
-    │ 下次同类文档推断更准确
-    ▼
-更好的自驱分析
-```
-
-**关键：每次假设被确认或否定，都是一次学习信号。**
-积累足够多的假设验证后，自驱推断的准确率会持续提高。

package/skills/req-mining/feedback-questions.sh

@@ -1,9 +0,0 @@
-#!/bin/bash
-# req-mining 领域专属反馈问题
-# 由 scripts/feedback-hook.sh 在交互模式下 source 本文件
-
-QUESTION_1="哪些需求描述不清晰或有歧义？"
-QUESTION_2="遇到了哪些文档未覆盖的技术决策？"
-QUESTION_3="发现哪些需求假设与现实不符？"
-QUESTION_4="哪些验收标准无法被自动测试？"
-QUESTION_5="总体反馈（实现难度、文档质量评分 1-10）："