@ghyper9023/pi-dev-workflow 0.6.2 → 0.7.0

package/.github/workflows/release.yml

@@ -0,0 +1,56 @@
+# 发布 GitHub Release
+#
+# 触发：推送 v* 标签时（如 v0.7.0）
+# 行为：自动读取 .version/RELEASE-<tag>.md 作为 release 内容；
+#       若未找到对应版本说明文件，则写入默认提示，引导查看 git commit 确认变动。
+#
+# 版本说明文件命名约定：.version/RELEASE-v0.7.0.md（与 tag 同名）
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: 检出代码
+        uses: actions/checkout@v4
+
+      # 读取本 tag 对应的版本说明；不存在或为空时写默认提示。
+      - name: 准备 release 说明
+        shell: bash
+        run: |
+          TAG="${GITHUB_REF_NAME}"
+          FILE=".version/RELEASE-${TAG}.md"
+          BODY_TMP="/tmp/release-body.md"
+
+          if [ -s "$FILE" ]; then
+            cp "$FILE" "$BODY_TMP"
+            echo "已读取版本说明: $FILE"
+          else
+            sed "s|__TAG__|${TAG}|g" > "$BODY_TMP" <<'EOF'
+          > [!WARNING]
+          > 本版本 `__TAG__` 未找到对应的版本说明文件（`.version/RELEASE-__TAG__.md`）。
+          >
+          > 请通过 git commit 记录确认本次发布的改动内容，例如：
+          >
+          > ```bash
+          > git log --oneline "<上一个标签>"..__TAG__
+          > ```
+          >
+          > 建议在 `.version/RELEASE-__TAG__.md` 中补充完整的 release 说明，release 会自动读取该文件。
+          EOF
+            echo "未找到版本说明 $FILE，已写入默认提示"
+          fi
+      - name: 创建 GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.ref_name }}
+          name: ${{ github.ref_name }}
+          body_path: /tmp/release-body.md

package/.pre-commit-config.yaml

@@ -0,0 +1,75 @@
+# .pre-commit-config.yaml
+# 优先使用 prek run --all-files 命令扫描 or 通过 git 自动触发
+repos:
+  # ============================================================
+  # 1. 通用文件检查（pre-commit-hooks v6.0.0）
+  # 官方仓库：https://github.com/pre-commit/pre-commit-hooks
+  # 注意：v6.0.0 要求 Python >= 3.9，并移除了
+  #       check-byte-order-marker 和 fix-encoding-pragma 两个钩子
+  # ============================================================
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      # 移除行尾多余的空格
+      # 覆盖 TS/JS/JSON/YAML/Markdown 等文本文件
+      - id: trailing-whitespace
+        name: 移除行尾多余空格
+
+      # 检查代码中是否有未解决的合并冲突标记（<<<<<<< / ======= / >>>>>>>）
+      - id: check-merge-conflict
+        name: 检查合并冲突标记
+
+      # 检查新增文件是否过大（默认限制 10240KB，即 10MB）
+      - id: check-added-large-files
+        name: 检查添加文件是否过大
+        args: ['--maxkb=10240']
+
+      # 检查 YAML 语法是否正确（如 CI 配置、docker-compose 等）
+      - id: check-yaml
+        name: 检查 YAML 语法
+
+      # 检查 JSON 语法是否正确（如 package.json 等）
+      # 排除常见的 JSONC 文件：tsconfig / jsconfig 通常允许注释
+      - id: check-json
+        name: 检查 JSON 语法
+        exclude: '^(tsconfig|jsconfig)(\..*)?\.json$'
+
+      # 检测私钥文件（SSH / PGP / RSA 等）是否被误提交
+      # 防止敏感私钥泄漏到仓库
+      - id: detect-private-key
+        name: 检测私钥文件
+
+  # ============================================================
+  # 2. 密钥泄露检测（Betterleaks，使用本机已安装版本）
+  # 官方仓库：https://github.com/betterleaks/betterleaks
+  # 通过 brew install betterleaks 或 brew install betterleaks/tap/betterleaks 安装
+  # 版本：v1.8.1（2026-08-18 发布）
+  # 说明：
+  #   - Gitleaks 已进入仅安全补丁维护阶段，Betterleaks 为其官方继任者
+  #   - 由 Gitleaks 原作者 Zach Rice 及原班人马维护
+  #   - 完全兼容原有的 .gitleaks.toml 配置和 .gitleaksignore 文件
+  #   - 检测 800+ 种密钥类型，支持 Expr 过滤、密钥有效性验证等高级功能
+  #   - 改用 local + system，直接调用本机 PATH 中的 betterleaks，
+  #     避免 prek 下载 Go 工具链并重新编译安装
+  # ============================================================
+  - repo: local
+    hooks:
+      - id: betterleaks
+        name: 检测密钥泄露
+        entry: betterleaks git --pre-commit --staged --verbose
+        language: system
+        pass_filenames: false
+
+  # ============================================================
+  # 3. ast-grep 结构化规则检查
+  # 官方仓库：https://github.com/joshuadavidthomas/ast-grep-rules
+  # 最新版本：v0.5.0（2026-07-25 发布）
+  # 说明：使用 AST 进行结构化代码搜索与检查，支持自定义 YAML 规则
+  # 这里只对 TS/JS 相关文件运行，避免检查无关语言文件
+  # ============================================================
+  - repo: https://github.com/joshuadavidthomas/ast-grep-rules
+    rev: v0.5.0
+    hooks:
+      - id: all
+        name: ast-grep 结构化检查
+        files: '\.(ts|tsx|js|jsx|mjs|cjs)$'

package/.version/RELEASE-v0.7.0.md

@@ -0,0 +1,85 @@
+# Release v0.7.0
+
+> 核心变化：**彻底移除子代理架构**。不再 spawn 隔离子代理进程，Git 命令、Grill 追问、PRD 生成、代码审查全部由当前代理直接执行（当前模型普遍具备 ≥1M 上下文窗口，无需隔离上下文）。
+
+## 🚀 Features
+
+### 移除子代理基础设施
+- 删除 `extensions/sub-agents.ts`（954 行）、`extensions/workflow-engine.ts`（2005 行）及 `agents/` 目录下全部 14 个 agent 定义
+- 移除 `.doc/AGENT-FRONTMATTER-REFERENCE.md` 与 6 个依赖子代理的旧测试，合并为单一回归测试套件 `tests/test-no-subagents.mjs`
+
+### Git 命令直接执行 / 委托分批提交
+- `/git-commit`、`/git-push`、`/git-commit-push` 改用 pi 内置执行器直接运行 git，不再委派 git 子代理
+- **传入消息**：快速路径暂存全部 → 提交（/git-commit-push 再推送）
+- **空消息**：把提交任务整体交由当前代理——自行执行 `git status` / `git diff` 识别变更，按 Conventional Commits 规范**分批提交**（提交信息用中文），直接执行无需确认；/git-commit-push 完成后自动推送
+
+### Grill 与 PRD 在当前代理运行
+- 方案追问完善（Grill）与 PRD 生成不再 spawn 子代理，由当前代理通过 `write` 工具落盘结果，扩展侧**轮询产物**读取（`pollFor`，间隔 2s、超时 5 分钟）
+- `/dev-*` 向导组装完提示词后直接投递给当前代理，新增自动审查意图检测（可路由到 review-html skill）
+- 生成追问问题 / PRD 前补充「已提交给当前代理生成…」的可见性提示，替代被移除的子代理 loading 面板
+
+### /dev-* 向导精简（2-4 轮概念式提问）
+- 提问按「核心任务 → 验收标准（可跳过）→ 额外补充（可跳过）」组织，全部命令 2-4 轮完成
+- 新增智能默认填充：自动探测项目语言、测试命令、lint 命令、pre-commit 钩子与 CI 配置
+- 四段式组装「角色 / 任务 / 验收标准 / 额外补充」，缺省字段注入流畅默认值，提示词不空白不违和
+
+### 自动审查（单模式）
+- 移除子代理时代残留的「后台异步审查」选项——当前审查在**当前代理**中运行，不存在"后台不阻塞"能力，改为单一模式：「开始审查（阻塞，等待报告）」/「不是审查（放行）」
+- 审查报告按**审查开始时间**过滤，不再误报上次遗留的旧报告
+
+### 工程化
+- 新增 `.pre-commit-config.yaml`：通用文件检查（trailing-whitespace、冲突标记、大文件、YAML/JSON 校验、私钥检测）+ betterleaks 密钥泄露扫描 + ast-grep 结构化检查
+- 新增 GitHub Release 自动化（`.github/workflows/release.yml`）：推送 `v*` 标签时自动发布，读取 `.version/RELEASE-<tag>.md` 作为 release 内容，未找到时写入引导查看 git commit 的默认提示
+
+## 🐛 Bug Fixes
+
+- 修复 `ctx.waitForIdle(超时)` 参数无效与**时序误判**问题：SDK 签名不接受超时参数，且 `waitForIdle` 可能在 `sendUserMessage` 触发的新 turn 开始前立即返回，导致"瞬间完成"误报。统一改为「发消息 → `pollFor` 轮询产物（文件/会话文本）」，覆盖 git-commands、grill-me-agent、dev-prompts（runReview）全部场景，根治 commit message 提取失败、审查 0.0s 完成、Grill/PRD 读取提前等问题
+- 修复 `pi.on("input")` 未过滤扩展注入消息（`event.source === "extension"`）导致的递归风险
+- 修复审查功能 `pi.sendUserMessage("/skill:review-html")` 未设置 `expandPromptTemplates` 导致 skill 不展开的问题
+- 修复审查报告缓存误报：`findNewestReviewHtml` 仅返回审查开始时间之后生成的文件（此前会立刻报出上次遗留报告）
+- 修复 PRD 生成失败时静默返回无提示的问题，增加错误通知
+- 修复 `pi.exec` 返回字段误用（`exitCode` → `code`，git 命令因此被误判失败并提示"未知错误"）
+- 移除子代理时代遗留的 `loaderLabel` 加载面板文案（BorderedLoader 删除后成为死变量）
+
+## 🔧 Refactor
+
+- 新增 `extensions/session-utils.ts`：项目探测（语言/测试命令/lint/pre-commit/CI）、默认验收标准生成、`pollFor` 轮询、会话文本提取（改走 `getEntries()`，摆脱 branch/leaf 语义依赖）
+- git-commands 与 grill-me-agent 解除互相依赖，公共工具统一由 session-utils 提供
+- 移除 `ui-helpers.ts` 工作流进度 widget 面板（约 780 行）及其相关状态类型
+- 清理未使用 import、死代码分支与文件末尾缺失换行
+- README、APPEND_SYSTEM.md、package.json 元数据同步新架构
+
+## 📦 Files Changed
+
+| 类别 | 文件 |
+|---|---|
+| 删除 | `extensions/sub-agents.ts`、`extensions/workflow-engine.ts`、`agents/`（14 个 md）、`.doc/AGENT-FRONTMATTER-REFERENCE.md`、6 个旧测试 |
+| 新增 | `extensions/session-utils.ts`、`tests/test-no-subagents.mjs`、`.pre-commit-config.yaml`、`.github/workflows/release.yml` |
+| 修改 | `extensions/git-commands.ts`、`extensions/grill-me-agent.ts`、`extensions/dev-prompts.ts`、`extensions/ui-helpers.ts`、`README.md`、`prompts/APPEND_SYSTEM.md`、`package.json` |
+
+## 🔗 Commit History
+
+```
+b2ed701 feat: git 委托提交任务补充执行约束（仅提交、快速执行）
+176a1c2 feat: git 命令空消息时交由主代理识别变更并分批提交
+b888b64 feat: 简化自动审查模式，移除后台异步审查，只保留阻塞式单模式
+a22f498 refactor: 用产物轮询替代 waitForIdle 时序等待，移除 loaderLabel 提示参数
+3c62779 docs: 添加 v0.7.0 版本发布说明
+8d751c7 ci: 新增 v* 标签触发的 GitHub Release 自动化
+c846996 docs: 添加第三方推荐扩展列表
+54218ac feat: 精简 /dev-* 向导为概念式提问并智能默认填充
+c599a25 chore: bump version to 0.7.0
+462ccfd chore: 修正 README 措辞、pre-commit 大文件检查范围与 SKILL 尾随空格
+6801299 test: 补充超时等待与审查入口的回归断言
+6cb3243 fix: 审查检测过滤扩展注入消息防递归，skill 命令正确展开
+b92131f fix: grill/PRD 等待当前代理带超时，PRD 失败增加错误提示
+e8347f3 fix: git 命令等待带超时，共享会话工具下沉至 session-utils
+c8b55b9 feat: 添加 .pre-commit-config.yaml 文件，配置通用文件检查和密钥泄露检测
+1fa91f5 docs: 更新文档与元数据，反映子代理移除后的新架构
+8c6add1 refactor: 移除工作流进度 widget 面板代码
+d27a031 feat: /dev-* 向导组装完提示词后直接发送给当前代理
+4019c2e feat: Grill 与 PRD 在当前代理中运行，不再 spawn 子代理
+f9b8bef feat: run git commands directly instead of delegating to git-sub-agent
+410c21f test: replace sub-agent-dependent tests with single regression suite
+c03549a feat: remove sub-agent infrastructure
+```