ParallelizationAgent:基于鸿蒙 FFRT 的并行化改造平台项目

用户可借助此项目实现鸿蒙 FFRT 相关工程的自动化并行化改造。该项目由 AI Agent 完全托管,能自动完成需求评审、设计文档生成、代码编写、测试及提交等闭环流程,支持人机协同开发。【此简介由AI生成】

Branch3Tags0

鸿蒙 FFRT 并行化改造平台 - Agent 工作区

⚠️ 【人类开发者必读警告】 ⚠️ 本项目是一个由 AI Agent(大语言模型)完全托管与驱动 的自动化工程车间。 这里的核心代码、架构设计和进度追踪均由 AI 按照严格的 SOP(标准作业程序)自动维护。请人类开发者尽量避免直接手动“Hack”业务代码,以免破坏 AI 的状态机与上下文记忆。


🛠️ 人机协同工作流 (How to Work with the Agent)

作为人类,你的核心角色是产品经理(PM)和代码审查员(Reviewer)。推进项目的标准姿势如下:

  1. 提出需求:修改 docs/spec.md,或直接唤醒 AI 并用大白话描述你要做的新功能。
  2. 触发红队审查:AI 会自动进入 design_review.md 流程,向你连发追问(极端场景、UI 状态、数据流向)。
  3. 人类拍板:回答 AI 的问题。AI 会在 specs/SPEC-XX/ 目录下生成完整的设计文档和 SPEC-XX-tasks.json。
  4. 喝茶等待:输入”开始编码”,AI 将严格按照 SPEC-XX-tasks.json 自动完成写代码、跑测试、写日志、提交 Git 的闭环。
  5. 验收确认:AI 遇到阻塞或完成任务时会主动停下等待你的指令。

📂 目录结构与领域模型

.
├── CLAUDE.md                 # 🤖 AI 的系统内核与最高宪法(定义了 7 步 SOP 铁律)
├── design_review.md          # 🛡️ 需求评审网关(必须先过此关才能写代码)
├── finding.md                # 🧠 AI 的长期记忆库(记录 PTY/hdc 等底层踩坑经验)
├── progress.md               # 📜 事务日志(记录 AI 的每一次 Commit 和动作)
├── README.md                 # 👤 你正在阅读的文件
│
├── docs/                     # 📚 全局业务与技术数据源 (SSOT)
│   ├── architecture.md       # 技术栈选型与 UI 审美底线约束
│   ├── spec.md               # 全局规格总线(记录了所有 SPEC-XX 的状态)
│   ├── dictionary.md         # 全局名词解释与通用类型字典(防止 AI 命名幻觉)
│   └── template/             # 预置的标准化交付模板 (Feature / Plan / Tasks / TDD)
│
└── specs/                    # 🏭 动态特征舱(AI 的编码车间)
    ├── SPEC-01/              # 每个子功能独立的上下文隔离区
    └── ...

🚨 紧急干预指南

如果发现 AI 陷入死循环、产生严重幻觉,或底层 hdc 进程彻底卡死:

  1. 立刻对 AI 输入 /exit 强制打断当前会话上下文。
  2. 手动执行 pkill -f "hdc" 或清理 SANDBOX_ROOT 目录(默认 tempfile.gettempdir()/ffrt_sandbox/)。
  3. 检查 specs/SPEC-XX/SPEC-XX-tasks.json,将错误的任务状态从 done 改回 todo。
  4. 重新唤醒 AI,并附带报错日志让其重新评估。

Introduction

用户可借助此项目实现鸿蒙 FFRT 相关工程的自动化并行化改造。该项目由 AI Agent 完全托管,能自动完成需求评审、设计文档生成、代码编写、测试及提交等闭环流程,支持人机协同开发。【此简介由AI生成】

Customize your domain