@succsoft/succapp 5.0.1 → 5.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,12 +1,8 @@
1
1
  {
2
2
  "name": "@succsoft/succapp",
3
- "version": "5.0.1",
3
+ "version": "5.0.2",
4
4
  "description": "SuccApp CLI for AI-assisted low-code development, metadata workspace sync, and server automation.",
5
5
  "license": "SEE LICENSE IN LICENSE",
6
- "repository": {
7
- "type": "git",
8
- "url": "https://gitlab.succez.com/product/bi"
9
- },
10
6
  "bin": {
11
7
  "succapp": "dist/cli/succapp.js"
12
8
  },
@@ -1,40 +1,19 @@
1
1
  # SuccApp AI 工作区
2
2
 
3
- 本目录保存当前 SuccApp 工作区的 AI 共享上下文和 AI 协作产物。
3
+ 本目录保存 SuccApp 工作区里的 AI 协作规则和产物。开始修改业务内容前,先读工作区根目录的
4
+ `AGENTS.md`,再按任务需要阅读这里的规则或 skill。
4
5
 
5
- ## 与主入口的关系
6
-
7
- `../AGENTS.md` 是常用 AI 工具优先读取的主入口。本文件补充工作区目录、AI 产物目录和本地
8
- 运行态说明。修改内容前应先读 `../AGENTS.md`,再按需阅读本文件和 `rules/` 下的细则。
9
-
10
- ## 工作区目录
11
-
12
- - 工作区根目录通常包含一个或多个从服务器克隆下来的元数据项目目录。
13
- - 项目文件是可编辑的交付内容,例如页面、报表、模型、脚本、扩展和配置等元数据文件。
14
- - `.meta` 文件保存每个资源的服务器标识、版本和元信息,是 SuccApp 同步和差异判断的重要依据。
15
- - `.succapp/` 保存本地服务器配置、镜像、缓存、锁、合并备份、日志和 IDE 辅助文件。
16
-
17
- 更多修改安全边界见 `../AGENTS.md`。
18
-
19
- ## 目录说明
6
+ ## 目录
20
7
 
21
8
  - `plans/`:实施计划、迁移计划和多步骤任务计划。
22
- - `reviews/`:Code Review、设计评审和变更评审。
23
- - `reports/`:调查报告、分析报告和验证报告。
9
+ - `reviews/`:Code Review、设计评审和变更评审结果。
10
+ - `reports/`:调查、分析、验证和排查报告。
24
11
  - `rules/`:团队长期维护的 AI 协作规则。
25
- - `skills/`:面向特定开发场景的 AI skill,例如 SuccBI 前端定制开发。
12
+ - `skills/`:面向特定开发场景的 AI skill
26
13
  - `tmp/`:临时脚本、草稿和一次性排查文件。
27
14
 
28
- SuccApp 运行态文件保存在 `.succapp/` 下。`remote`、`cache`、`locks`、`merge-base`、
29
- `merge-backup`、日志文件和 `state.json` 都属于本地运行态。
30
-
31
- ## AI 产物规则
15
+ ## 规则
32
16
 
33
- - 非简单任务的实施计划写到 `plans/`。
34
- - 评审结果写到 `reviews/`。
35
- - 调查、分析和验证总结写到 `reports/`。
36
- - 临时脚本和一次性草稿写到 `tmp/`。
37
- - 团队长期规则写到 `rules/`,不要只写在个人对话提示词里。
38
- - 可复用的场景化开发指南写到 `skills/`,并在任务命中时先阅读对应 `SKILL.md`。
39
- - `plans/`、`reviews/`、`reports/` 和 `tmp/` 默认忽略其中的文件。AI 产物需要长期保留时,
40
- 应先由人工确认,再调整忽略规则或移动到团队约定位置。
17
+ - 计划、评审、报告和临时文件分别放入对应目录,不要散落在业务项目目录里。
18
+ - 长期规则放入 `rules/`,可复用开发指南放入 `skills/`。
19
+ - `plans/`、`reviews/`、`reports/` `tmp/` 默认忽略其中的文件;需要长期保留时先由人工确认。
@@ -1,15 +1,14 @@
1
1
  # SuccApp 工作区 Agent 说明
2
2
 
3
- 本工作区用于保存由 SuccApp 管理的元数据项目。SuccApp 是 SuccBI、SuccCI、SuccAP 配套的
4
- VS Code 扩展,支持元数据同步、脚本开发、扩展开发、Git 协作和 AI 辅助修改。
3
+ 本工作区用于保存由 SuccApp 管理的低代码元数据项目。SuccApp 是面向低代码项目交付、二次开发和
4
+ AI 辅助开发的配套工具,提供 SuccApp CLI SuccApp for VS Code 两个入口,支持元数据同步、
5
+ 脚本开发、扩展开发、Git 协作和 AI 辅助修改。
5
6
 
6
7
  ## 产品上下文
7
8
 
8
- - SuccBI 是商业智能平台,面向数据接入、数据加工、仪表板、可视化分析、自助分析和报表场景。
9
- - SuccCI 是报表报送和数据采集平台,面向表单设计、填报、审批、上报和汇总流程。
10
- - SuccAP 是低代码应用平台,面向模型驱动的业务应用、页面、流程、权限和自定义交互。
11
- - SuccApp 操作的是这些产品的本地元数据文件。这里的修改仍需要人工评审、服务器验证、Git
12
- 评审和发布确认。
9
+ - SuccApp 的核心思路是把页面、仪表板、报表、数据模型、程序流、脚本、主题和配置等低代码元数据保存为本地文件。
10
+ - 项目成员和 AI Agent 可以在本地修改这些文件,再通过 SuccApp CLI 或 SuccApp for VS Code 查看差异、拉取服务器变化、推送到测试环境,并按团队流程提交 Git 和发布生产。
11
+ - 本工作区中的修改仍需要人工评审、服务器验证、Git 评审和发布确认。
13
12
 
14
13
  ## 修改前必须读取
15
14