什么是wacai-index-official-website-demand-change
wacai-index-official-website-demand-change 是一个专为官网项目需求变更设计的自动化工具，旨在将用户的需求快速转化为可执行的代码修改流程。该工具通过接收用户输入的新需求及对应的项目路径，自动完成从需求入库到代码推送的完整操作链，显著提升开发效率并减少人为干预带来的错误风险。其核心优势在于不再依赖硬编码的项目路径，而是动态识别用户指定的 `project_dir`、`target_branch` 和 `demand_file_name` 参数，实现高度灵活的定制化执行。整个流程包括预检 Git 工作区状态、同步目标分支、备份需求内容至 `productdemand.md` 文件、调用子代理进行代码修改、运行必要检查、提交并推送更改，并在成功后触发企业微信通知。这一系列操作均在后台静默完成，最终向用户提供清晰的执行结果反馈。 该工具特别适用于需要频繁响应产品需求变化的前端或全栈开发场景，尤其是针对官网类项目。它避免了传统手动操作流程中繁琐的步骤——如手动拉取代码、编写需求文档、逐一修改文件、运行测试、提交推送等——从而大幅缩短交付周期。同时，内置的失败处理机制确保在出现工作区脏数据、网络异常或构建失败等情况时能够及时中断并告警，防止错误代码进入生产环境。此外，企业微信通知功能不仅增强了团队协作透明度，也为项目经理提供了实时的任务进展追踪能力。整体而言，这是一个集自动化、安全性和可追溯性于一体的智能开发辅助工具。
核心功能特点
- 支持动态传入项目路径，无需硬编码，提升通用性与灵活性
- 自动完成需求录入、代码修改、检查、提交与推送全流程
- 内置 Git 工作区预检与同步机制，保障代码库一致性
- 自动生成并备份需求文档至 productdemand.md，便于追溯与管理
- 成功推送后自动发送企业微信 webhook 通知，包含时间、路径、分支及变动详情
- 完善的错误处理逻辑，遇阻即停并明确告知用户具体原因
适用场景
该工具最典型的应用场景是官网项目的日常迭代维护，例如首页 SEO 优化、友情链接样式调整或新增功能模块等需求。当产品经理提出新需求后，开发人员只需将需求文本粘贴至工具接口，并提供对应的本地项目目录路径，即可启动自动化流程。系统会自动将需求写入 `productdemand.md` 作为开发依据，随后调用 AI 子代理生成相应代码变更，执行 lint 或构建检查，最后完成 git commit 和 push 操作。整个过程无需开发者手动介入每一步，极大提升了响应速度。 另一个适用场景是多分支协作开发环境，尤其是在持续集成（CI）流程尚未完全覆盖的小型团队中。由于工具默认使用 `feat/test` 作为目标分支且支持自定义分支名，因此非常适合用于特性分支的快速验证与合并。例如，某成员在本地完成某个功能开发后，可通过此工具一键将其推送到远端测试分支，并立即触发企业微信通知，让团队成员第一时间知晓变更内容。这不仅简化了发布流程，也强化了团队间的协同沟通效率。 此外，对于需要频繁回滚或审计变更记录的场景，该工具的价值尤为突出。每次执行都会生成带时间戳的 commit 信息（如 `chore: 官网需求变更-20260310-162000`），并结合 `productdemand.md` 的内容形成完整的变更上下文。即使后续出现问题，也能快速定位责任节点与修改范围。这种可追溯的设计使得它在对合规性要求较高的企业环境中同样具备实用意义。