v1.0.0 — DevTaskFlow 1.0 正式版

🎉 DevTaskFlow 1.0 正式版

架构回归 OpenClaw 原生能力

架构重构

• 新建 lib/openclaw_config.py — 自动从 OpenClaw 配置读取 model / base_url / api_key
• lib/llm.py / lib/orchestrators/openclaw_subagent.py — env var 读不到时自动 fallback
• 用户零配置：运行在 OpenClaw 环境内自动获取 LLM 设置

安全清理

• SKILL.md 删除全部 9 个冗余 env var 声明（requires: {}）
• 消除 ClawHub 安全扫描 credential Note

配置简化

• lib/doctor.py — 诊断项改为 OpenClaw 自动检测
• lib/setup_flow.py — auto 模式零输入
• templates/config.json — 精简模板

安装

clawhub install devtaskflow

完整 Changelog

v0.10.0: Git 自动化 — 新建/迭代项目自动使用 Git

v0.10.0 (2026-03-27)

Git 自动化 — 每次新建/迭代项目自动使用 Git

之前 DevTaskFlow 只在封版时才做 git commit，新建项目不会自动 git init，中间步骤也没有版本记录。现在全流程自动覆盖。

新增 lib/git_utils.py — Git 工具模块

• check_git_installed() — 检测 git 是否已安装，未安装时返回安装命令提示
• is_git_repo() — 检测目录是否已是 git 仓库
• ensure_git_repo() — 自动 git init + 设置 main 分支 + 首次 commit
• auto_commit(message) — 自动 git add . + git commit，有变更才提交，无变更静默跳过

项目初始化自动 Git

• dtflow init 创建项目结构后，自动检测并初始化 git 仓库
• 首次 commit 包含所有初始文件（config.json、目录结构等）

Write / Fix 阶段自动 Commit

• Write 完成 → 自动 commit：feat: 实现代码
• Fix 完成 → 自动 commit：fix: 修复审查问题
• 每步原子化记录，方便追溯每个阶段的代码变更

封版前自动确保 Git 仓库

• dtflow seal 执行前，先检查项目是否是 git 仓库
• 不是的话自动初始化，避免封版时 git commit 失败

Doctor 新增 Git 检查

• dtflow doctor 诊断时新增 git 安装状态检测

设计原则

• Best-effort — 所有 git 操作失败只打印 ⚠️ 警告，不阻塞主流程
• 智能跳过 — 无变更时自动跳过 commit，避免空提交报错
• 零配置 — 无需额外配置，装了 git 就能用

v0.9.0: 错误恢复 + 配置简化 + 封版自动化

v0.9.0 (2026-03-25)

错误恢复机制 — 三层保障

• retry_with_backoff 指数退避自动重试（集成到所有 LLM 调用）
• 检查点机制（checkpoint/list_checkpoints/restore_checkpoint）
• dtflow advanced rollback — 回滚到检查点
• dtflow advanced recover — 自动检测修复 6 类状态异常
• 友好错误提示扩展到 14 种

配置三档模式

• 极简模式：自动检测已有配置，零输入
• 引导模式：3 步完成（选模型 → 填 Key → 选部署）
• 高级模式：完整手动配置
• dtflow setup --mode auto|guided|advanced

封版自动化

• 封版自动生成 CHANGELOG.md
• 封版后自动创建下一版本目录
• DEPLOYMENT.md 从 config.deploy 自动填充

v0.8.0

Changelog

v0.8.0 (2026-03-24)

Feature: OpenClaw 编排器 + ClawHub 发布

• openclaw_subagent.py 完全重写：从纯占位变为完整实现
  • 新增 _OpenClawLLM 类，独立于 local_llm，从 config.openclaw 读取 base_url / api_key / model
  • 支持全部 5 个 action：analyze / write / review / fix / comprehensive_review
  • 支持环境变量 fallback（DTFLOW_OPENCLAW_*）
  • prompt 加载、JSON 解析、FILE block fallback 与 local_llm 一致
• publish_flow.py 新增 ClawHubPublishAdapter
  • 检查 clawhub CLI 可用性 + 登录状态
  • 验证 SKILL.md 存在
  • 调用 clawhub publish 发布
  • 结果记录到 state
• cli.py：publish 命令 --target 新增 clawhub 选项
• templates/config.json：
  • openclaw 段新增 base_url / api_key / model 字段
  • adapters.publish 默认值改为 clawhub
• docs/B2_IMPLEMENTATION_PLAN.md 更新为全部 Phase 已完成

v0.7.0 (2026-03-23)

Feature: React Best Practices + Web UI Quality Guidelines

• 集成 Vercel React 最佳实践（64 条规则）到 write_system.md — 代码生成时自动遵循：并行请求、动态导入、大列表虚拟化、避免 transition:all、hydration 安全、交互状态、文案规范
• 集成 Vercel Web Interface Guidelines 到 review_system.md — review 时自动检查 6 项 React 性能 + 10 项 UI 质量（无障碍、焦点状态、表单、动画、排版、内容处理、深色模式等）
• comprehensive_review_system.md 从 7 维度扩展到 9 维度：新增 React 性能审查和 Web UI 质量审查
• 文案规范：主动语态、Title Case、数字代替文字、按钮标签具体化、错误消息含修复步骤

v0.6.0 (2026-03-21)

Feature: Design System + User Guide + Comprehensive Review

• Analyze 阶段新增设计系统规范输出（色彩/字体/间距/组件/交互/响应式）
• analyze 完成后自动生成 DESIGN_SYSTEM.md
• Write 阶段自动生成 docs/USER_GUIDE.md（面向最终用户的使用说明书）
• Write 阶段 UI 代码强制遵循 DESIGN_SYSTEM.md 规范
• 新增上线前综合审查阶段（7 维度：代码质量/安全性/交互友好度/需求符合度/设计一致性/字段依赖/命名规范）
• 新增 pending_final_review / ready_to_deploy / needs_final_fix 状态
• 新增 --final-review 和 --deploy-skip-review 命令
• 综合审查评分 <7 分自动触发修复循环

Compliance: Data Exposure Prevention

• cli.py: 部署信息脱敏显示（IP 保留首尾段，域名模糊化），不再直接打印 user/path
• cli.py: 新增 _mask_host() 脱敏函数
• SKILL.md: 主动调用策略改为"识别意图 → 建议用户 → 等待确认后执行"，不再无条件自动触发

v0.5.1 (2026-03-19)

Security Fix: Shell Injection Prevention

• deploy_adapter.py: Replace shell=True with shlex.split() for safe argument parsing
• run_flow.py: Use argument lists for npm/pip/python commands, remove shell=True
• Eliminates all shell=True usage across the codebase

v0.5.0 (2026-03-19)

Security Fix: ClawHub Review Response

• board/server.js: Sanitize API responses — remove deploy host/user/path exposure
• board/server.js: Filter sensitive fields from .state.json (publish details, error internals)
• landing/serve.py: Remove hardcoded absolute path /home/admin/.openclaw/..., use relative paths
• SKILL.md: Declare optional deploy/publish env vars (DTFLOW_GITHUB_TOKEN, DTFLOW_DEPLOY_SSH_KEY, DTFLOW_DOCKER_REGISTRY)
• SKILL.md: Add board security notes (local-only, API already sanitized)

v0.4.9 and earlier

• Initial ClawHub releases
• Core pipeline: analyze → write → review → fix → deploy → seal
• Board dashboard (Node.js + Express)
• Deploy adapters: shell, ssh_shell, docker
• Publish adapters: GitHub releases
• OpenClaw subagent orchestration
• Auto-advance mode for unattended runs

v0.7.0 — React Best Practices + Web UI Quality

v0.7.0 (2026-03-23)

Feature: React Best Practices + Web UI Quality Guidelines

• 集成 Vercel React 最佳实践（64 条规则）到 write_system.md — 代码生成时自动遵循：并行请求、动态导入、大列表虚拟化、避免 transition:all、hydration 安全、交互状态、文案规范
• 集成 Vercel Web Interface Guidelines 到 review_system.md — review 时自动检查 6 项 React 性能 + 10 项 UI 质量（无障碍、焦点状态、表单、动画、排版、内容处理、深色模式等）
• comprehensive_review_system.md 从 7 维度扩展到 9 维度：新增 React 性能审查和 Web UI 质量审查
• 文案规范：主动语态、Title Case、数字代替文字、按钮标签具体化、错误消息含修复步骤

v0.6.0 - Design System + Comprehensive Review + Compliance

DevTaskFlow

不会写代码，也能把想法做成软件。

用自然语言发起开发任务，AI 驱动的开发流水线 —— 需求 → 方案 → 设计规范 → 代码 → 7 维度审查 → 修复 → 部署 → 归档，一条链路跑通。

---

它怎么工作

你只需要做一件事：用大白话说清楚你想做什么。

跟 OpenClaw 聊天框里直接说：

帮我做一个客户管理工具，给销售团队用，需要录入客户、搜索、跟进状态、备注，界面简洁，手机也能用。

DevTaskFlow 自动完成剩下的事：

步骤	做什么	你需要做什么
需求分析	拆成功能清单 + 技术方案 + 设计规范	确认或提出修改
代码生成	AI 写出完整项目代码	预览确认
代码审查	逐任务检查代码质量	看结果
自动修复	发现问题立刻修复再复审	无
综合审查	7 维度上线前全面检查	看报告
本地运行	启动项目让你实际看看	确认上线
部署上线	推到服务器	无
封版归档	保存版本快照 + 发布 GitHub	无

你不需要记命令，不需要手动切换步骤，系统根据当前状态自动推进。

---

为什么做这个

很多人有业务理解、有场景、有产品直觉，甚至比工程师更清楚问题出在哪里。但现实是：

• 不会写代码，就很难自己把工具做出来
• 找外包、排开发、反复沟通，时间和成本都很高
• 即使有 AI，对普通人来说也常常只是"会聊天"，离真正落地还差很远

DevTaskFlow 要解决的，不是"再做一个代码生成器"，而是把软件开发变成一条普通人也能走通的流程。

技术不该只服务会写代码的人。技术应该成为更多人的杠杆。

---

核心能力

从自然语言到可运行软件

• 用大白话描述需求，自动分析并拆任务
• 调用 LLM 生成完整项目代码（支持 Claude Opus 4.6、GPT 5.4、Mimo V2 Pro）
• 结构化代码审查，发现问题自动修复
• 支持本地运行、部署、封版、GitHub 发布
• 多项目看板，进度一目了然

v0.6.0 新增

• 设计系统规范 — 分析阶段自动生成色彩/字体/间距/组件/交互规范，UI 代码自动遵循
• 使用说明书 — 每个项目自动生成面向最终用户的 USER_GUIDE.md
• 7 维度综合审查 — 代码质量、安全性、交互友好度、需求符合度、设计一致性、字段依赖、命名规范
• 合规安全 — 部署信息脱敏、主动调用需用户确认

对非技术用户友好

不需要懂技术，像这样说就够了：

我想做一个内容发布管理台，支持账号管理、发布记录、草稿保存，先做 Web 版，团队内部使用。

给 AI 加上护栏

• 状态机推进，每一步都有记录
• 写入前可预览（dry-run）
• 审查 / 修复闭环，避免越修越乱
• 路径安全限制，不会写到项目外面
• 部署信息脱敏，敏感数据不暴露

---

适合谁

• 不会写代码但想把想法做出来的人 — 产品经理、运营、创业者、业务负责人
• 会写代码但想提升效率的人 — 快速验证想法、标准化开发流程
• 需要"流程可追踪"的团队 — 每一步都知道发生了什么，有版本记录可回溯

---

工作流

提需求 → 分析（含设计规范）→ 确认 → 生成代码（含使用说明）→ 逐任务审查 → 修复循环 → 综合审查（7 维度）→ 本地预览 → 部署 → 封版 → GitHub 发布

每一步都有状态，每一步都能继续 / 恢复，每一步都能被看见。

---

快速开始

1. 安装

DevTaskFlow 以 OpenClaw Skill 的形式运行。安装后，直接在 OpenClaw 对话中使用。

clawhub install devtaskflow

2. 配置

dtflow setup    # 交互式配置 AI 服务

3. 发起新项目

在 OpenClaw 聊天中直接说：

新建一个项目，叫 crm-lite，我想做一个给销售团队用的客户管理工具。

系统自动：创建项目 → 分析需求 → 生成设计规范 → 拆任务 → 写代码 → 审查 → 修复 → 综合审查 → 部署。

4. 查看进度

看下项目进度

或者用可视化看板：

dtflow board --serve    # → http://localhost:8765

---

常用操作

所有操作都通过自然语言完成。以下是一些示例：

"帮我分析一下这个需求能不能做"     → 启动需求分析
"方案没问题，开始写代码"           → 确认并生成代码
"先别部署，我想看看效果"           → 本地运行预览
"可以了，上线吧"                   → 部署上线
"发布到 GitHub"                    → 封版并创建 Release
"改成蓝色主题"                     → 反馈修改

---

安全与约束

• 写入路径限制在项目目录内
• 配置和密钥走环境变量 / 本地配置
• 部署信息脱敏显示（IP/域名模糊化）
• 主动调用需用户确认，不会无条件触发部署
• 写入前可预览（dry-run）
• 审查与修复分阶段执行
• 项目与版本分层管理

---

架构

  OpenClaw / 自然语言交互层
            │
  ┌─────────┴─────────┐
  │   pipeline core   │  开发主流程（analyze → write → review → fix → comprehensive_review → deploy → seal）
  │   orchestrator    │  调度层（本地 LLM / OpenClaw 子 agent）
  │   state + board   │  项目状态与看板
  │   adapters        │  对接外部能力（LLM、部署、归档、GitHub）
  └───────────────────┘

---

支持的模型

模型	说明
Claude Opus 4.6	综合能力最强，推荐复杂项目
GPT 5.4 Pro	OpenAI 旗舰，大型项目首选
GPT 5.4	性价比高，适合中小项目
小米 Mimo V2 Pro	国产模型，中文表现好

---

版本

当前版本：v0.6.0 — 查看完整更新日志

---

License

MIT-0 — 免费使用、修改、分发，无需署名。

v0.5.1 — Security: Shell Injection Prevention

Security Fix: Shell Injection Prevention

移除所有 shell=True 使用，消除 shell 注入风险：

• deploy_adapter.py: 用 shlex.split() 替代 shell=True，安全解析参数
• run_flow.py: npm/pip/python 命令改用参数列表，不再经过 shell

如需在部署命令中使用管道/重定向等 shell 特性，请通过 bash -c "your command" 包装。

v0.5.0 — Security: ClawHub Review Response

Security Fix: ClawHub Review Response

响应 ClawHub 安全审查反馈，修复以下问题：

• board/server.js: API 响应脱敏，移除 deploy host/user/path 暴露
• board/server.js: 过滤 .state.json 敏感字段（publish 详情、错误内部信息）
• landing/serve.py: 移除硬编码绝对路径，改用相对路径
• SKILL.md: 补充声明可选 deploy/publish 环境变量（DTFLOW_GITHUB_TOKEN, DTFLOW_DEPLOY_SSH_KEY, DTFLOW_DOCKER_REGISTRY）
• SKILL.md: 增加看板安全说明（仅限本地使用，API 已脱敏）

v0.4.1

DevTaskFlow v0.4.1

这个版本做了什么

• 完整的 CLI 工具链：setup / start / board / advanced
• 一条开发流水线：需求分析 → 方案确认 → 代码生成 → 审查 → 修复 → 部署 → 封版 → GitHub 发布
• 支持 4 种模型：Claude Opus 4.6 / GPT 5.4 Pro / GPT 5.4 / Mimo V2 Pro
• 可视化项目看板服务
• 交互式配置向导
• 示例项目

适合谁

• 不会写代码但想搭建工具的人（产品经理、运营、业务人员）
• 想快速验证想法的开发者
• 需要把 AI 开发流程标准化的团队

核心亮点

• 自然语言需求 → 可执行开发任务
• 写入前预览（dry-run）
• 状态机驱动的开发流程
• 审查 → 修复 → 复审闭环
• 项目看板 + 可视化仪表盘
• GitHub 发布自动化

文档

完整 README 见项目主页，包含架构图、快速上手指南、命令参考。