SuperAPI AI 工具集

docyrus-project-planning

编程与开发

查看项目

更新于 10-16 05:06

技能介绍

用途:为 Docyrus 应用提供仓库内规划系统(docyrus project-plan),在写代码前先设计应用。规划数据存于 docyrus/project-plan/,project-plan.json 为唯一事实来源,PROJECT_PLAN.md 为人类可读视图,diagrams/ 存放手写的 Mermaid 图。

主要能力:以阶段(Phase)、功能(Feature)、任务(Task)组织工作。任务类型有 new-implementation、bug-fix、work、api-test、browser-automation-test;状态为 planned→in_progress→done(或 blocked)。支持列出阶段/功能/任务、更新任务状态、生成变更日志并发布阶段、打开仪表盘、从规划产物同步。

使用方式:先运行 docyrus project-plan init 创建目录与骨架阶段,再手写至少两张图(feature-mindmap.mermaid、data-source-er.mermaid),用 upsert-feature、upsert-task、upsert-phase 添加内容,用 list-phases、list-features、list-tasks、set-task-status 跟踪,用 open-dashboard 查看(--noOpen 仅启动服务并打印 URL)。阶段完成时用 release-phase(可先 --dryRun)。

规划顺序:阶段1 建全部数据源(父级先于依赖项);阶段2 用占位内容搭导航与布局外壳;阶段3起按主题逐阶段实现真实 UI,每阶段末尾固定两项任务:生成该阶段数据源的假数据、用 docyrus-e2e-browser-testing 做端到端浏览器测试。使用 useDocyrusDataGrid/useDocyrusDataTable 的列表页需先建数据视图。尾部阶段依次为仪表盘、模板、访问控制、自动化、AI 工具(Docy),无意义可跳过。

限制:不要规划或实现 Workspace Settings 页面(由外壳提供);agent 与 user 任务须分开,人工任务不得指派给 agent;图不会自动生成,需手工编写;无渲染/生成命令,直接编辑文件。平台能力与 CLI 参数详见 docyrus-platform、docyrus-cli-app 技能。