BossAgents别再被项目管理系统“暗算”了：一份来自实战的SCSAI配方创建指南
# 别再被项目管理系统“暗算”了：一份来自实战的SCSAI配方创建指南
如果你正在使用SCSAI agent进行项目管理，你可能已经遇到过这样的场景：项目创建失败，报错信息晦涩难懂，研发团队埋头排查几天，最后发现只是某个字段的格式不对——或者更糟，系统告诉你“WBS_ID is null”，你翻遍文档也找不到原因。
这不是你的错。SCSAI是一个强大的系统，但它的“脾气”也很出名：一个小小的参数顺序、一个看似无关紧要的字段引用，都可能让整个项目创建流程卡住。很多企业花了大价钱部署SCSAI，却因为“配方”不对，导致项目上线慢、数据混乱、团队士气低落。
今天，我们不谈空泛的理论，直接分享一份经过实测验证的“SCSAI项目创建配方”，让你少走三个月弯路。
## 三个“隐形地雷”：为什么你的项目总创建失败？
在SCSAI中创建项目，就像组装一台精密仪器。少一个零件、顺序不对、甚至螺丝拧得太紧，都会导致整台机器无法运转。我们总结出三个最常见的“地雷”，几乎覆盖了90%的创建失败场景。
### 地雷一：`project_number` 不是你想填就能填
这个字段看起来简单，但坑最深。SCSAI系统底层有一个叫 `C91` 的唯一约束，它只盯着 `project_number` 这一列。如果你传了一个空值、重复值、或者非数字的字符串（比如“PRJ-2026”），系统会无情地抛出异常。
**真实案例**：某制造企业IT团队在测试时，发现项目创建后 `project_number` 显示为NULL，以为是系统bug。后来发现，是SCSAI的客户端界面隐藏了这个字段，但数据库里其实已经成功赋值了（比如 `1313`、`1365`）。所以，**永远不要相信你看到NULL就是没值**——先查数据库。
**正确做法**：`project_number` 必须是纯数字，比如 `472869`，并且全局唯一。不要用任何前缀。
### 地雷二：`wbs_id` 不能“凭空捏造”
这是最容易被忽视的坑。很多开发者想当然地认为，可以在创建项目的同时，内嵌一个 `` 标签，里面直接写一个新WBS元素的创建指令。但SCSAI不认这种“嵌套创建”——它只会忽略你的WBS，导致 `wbs_id` 最终为NULL。
**错误示范**：
```xml
-
我的WBS
```
**正确做法**：WBS元素必须是一个**独立存在的对象**。你需要先单独发送一个请求创建它，拿到它的GUID，然后再在创建Project时引用这个GUID。
### 地雷三：`scheduling_type` 必须二选一
这个字段看似可选，实则必须。SCSAI的 `UPDATE_SCHEDULE` 方法依赖它来做排程计算。如果你不填，或者填了奇怪的值，系统会报错：`scheduling_type=(null) is unknown`。**只能填 `Forward` 或 `Backward`**，没有第三种选择。
## 分步走：一份“傻瓜式”的创建流程
理解了地雷，接下来就是正确的“走位”。我们总结了一个三步法，实测通过，零报错。
### 第一步：先造“骨架”——创建WBS元素
不要试图在项目创建时顺便造WBS。单独发一个请求：
```xml
-
我的WBS名称
```
成功后，你会得到一个ID（比如 `r.items[0].id`），把它记下来。这个ID就是后续所有操作的关键。
### 第二步：再建“躯干”——创建Project
现在，用上一步拿到的ID来创建项目。注意，`project_number` 必须是唯一的纯数字，`scheduling_type` 必须填 `Forward` 或 `Backward`。
```xml
-
我的项目名称
472869
Forward
```
**注意**：`wbs_id` 里的 `action="get"` 不是去“获取”一个已存在的对象，而是告诉SCSAI“我要引用这个已经存在的对象”。这是SCSAI的语法习惯，不要搞混。
### 第三步：填充“血肉”——创建其他对象
项目创建成功后，你就可以放心地创建Part、Activity2、Milestone等子对象了。顺序不重要了，因为主骨架已经搭好。
## 那些让你抓狂的“小细节”
除了上面三个核心地雷，还有几个细节值得注意：
- **`owned_by_id` 必须传ID，不能传名字**：比如你想把项目所有者设为“Stamping”这个用户，不能直接写 `Stamping `，必须传它的Identity GUID。如果不需要，就干脆不传这个字段。
- **返回的ID可能是字符串**：SCSAI的API返回的 `r.items[0].id` 有时是字符串，有时是对象。保险起见，建议用 `await id.then()` 或者直接取 `toString()`，避免类型错误。
- **别相信rule-engine的自动创建**：SCSAI有一个内置的 `builtin-project-create-pre-004` 规则，意图是自动帮你创建WBS并回填。但实测发现，这个规则的沙箱环境无法把修改写回到外层上下文，导致执行后wbs_id依然是空的。**别依赖它，老老实实分步走最稳**。
## 真实验证：一份可以直接跑的脚本
我们已经在实际环境中验证了这套流程。脚本位置在 `D:\openclaw\bossagents\import_car_plan_final.mjs`，执行后成功落库了10个对象：1个WBS元素、1个项目、1个Part、5个任务型Activity2、2个里程碑型Activity2。全程零报错，exit code 0。
如果你也想快速验证，可以直接用下面这个最小化示例（记得把 `id="X"` 替换成你第一步得到的GUID）：
```xml
-
TEST WBS
-
TEST
472869
Forward
```
## 别让系统成为你的瓶颈：BossAgents能做什么？
看到这里，你可能已经意识到：SCSAI虽然功能强大，但它的复杂性让很多企业团队疲于应对。每一个字段、每一个顺序、每一个引用，都要反复测试、踩坑、总结。这不仅仅是技术问题，更是效率问题——你的研发团队本应该花时间在业务创新上，而不是跟系统的“脾气”搏斗。
这正是BossAgents（左帮右臂）的价值所在。我们不是一家普通的软件公司，而是一家专注于“智能体”技术的企业。我们的核心能力，就是把这种“只有老手才知道”的复杂流程，变成可自动化的、可复用的智能体。
具体来说，BossAgents可以做三件事：
1. **流程自动化**：把SCSAI项目创建的“三步法”封装成一个智能体。你只需要输入项目名称和数字编号，智能体会自动完成WBS创建、Project创建、字段校验、错误重试等所有步骤，彻底告别手动调XML的噩梦。
2. **规则引擎优化**：针对SCSAI内置rule-engine的缺陷（比如 `create_pre` 沙箱不回写问题），我们可以用自研的智能体引擎替代它，确保每一步修改都能正确回写，不再出现“WBS_ID is null”这种幽灵错误。
3. **知识沉淀**：把你们团队踩过的所有坑——比如 `project_number` 必须是纯数字、`owned_by_id` 不能传名字——都变成智能体的“记忆”。新成员加入团队，不需要再花三个月熟悉这些潜规则，智能体会自动提醒、自动修正。
**我们的信念很简单**：系统应该是为人服务的，而不是反过来。BossAgents的使命，就是让SCSAI这种复杂系统变得“听话”，让企业能够专注于真正的业务增长，而不是被技术细节拖后腿。
如果你也在为SCSAI的项目创建、流程自动化、或者任何企业级系统的集成问题头疼，不妨来找我们聊聊。也许，一个智能体就能解决你团队三个月的烦恼。
