@antprofuse/saddle-islands-workflow 0.1.0 → 0.1.1
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/SKILL.md +8 -6
- package/package.json +1 -1
- package/references/task-planning-review.md +10 -6
package/SKILL.md
CHANGED
|
@@ -9,11 +9,11 @@ description: 协调Islands正式输入、工程设计、独立测试和小程序
|
|
|
9
9
|
|
|
10
10
|
## 规划与路由
|
|
11
11
|
|
|
12
|
-
每次新迭代、新协同任务或实质改变目标、职责、输入、依赖、验收方式前，重新读取本正文及[任务规划规则](
|
|
12
|
+
每次新迭代、新协同任务或实质改变目标、职责、输入、依赖、验收方式前，重新读取本正文及[任务规划规则](references/task-planning-review.md)。跨轮恢复后准备重新规划或处理集中偏差时同样重读；普通进度查询无需机械重复。
|
|
13
13
|
|
|
14
14
|
阶段按职责、权威输入、交付结果、公开工具和交接条件划分，不按Agent数量划分。同一Agent承担多个阶段或多个Agent分别执行时，工作策略与验收标准一致。单Agent切换阶段也需读取对应Skill、核输入并保留交付依据，不以会话记忆省略交接，不因兼任而混淆测试期望与产品实现。阶段不必各建节点，按真实依赖决定并行与串行。
|
|
15
15
|
|
|
16
|
-
先落实用户允许的仓库、目录、版本和交付目标。按[职责边界](
|
|
16
|
+
先落实用户允许的仓库、目录、版本和交付目标。按[职责边界](references/ownership.md)建立来源变化到设计、测试和实现的影响关系，不因近期只处理某层而缩小完整迭代范围。
|
|
17
17
|
|
|
18
18
|
| 工作 | 使用的角色或权威输入 |
|
|
19
19
|
|---|---|
|
|
@@ -28,9 +28,11 @@ description: 协调Islands正式输入、工程设计、独立测试和小程序
|
|
|
28
28
|
|
|
29
29
|
正式physical绑定和上游生成协议作为输入消费，不默认恢复独立adapt或人工外部协议设计阶段。真实语义缺口回报责任方，不向执行者下放未知设计或要求试到能跑。
|
|
30
30
|
|
|
31
|
+
任务节点只声明明确输入及版本、所用Skill与阶段、范围和Git分支或共享目录交付目标。通用执行、门禁、复盘和交付细则由Skill与工具说明承载，不在节点重复维护；上游产物的精确提交由检查点确认后交接。
|
|
32
|
+
|
|
31
33
|
## 工具与规则消费
|
|
32
34
|
|
|
33
|
-
通用工具来自独立工具集，使用其公开入口；本Skill及其他角色Skill不包含执行、观察、断言和报告实现。Owner
|
|
35
|
+
通用工具来自独立工具集，使用其公开入口；本Skill及其他角色Skill不包含执行、观察、断言和报告实现。Owner交接实际可取得的工具包及公开说明、适用输入及输出，不重新规定已经工具化的内部细节。缺失能力由公共维护者修复，不让消费者另写同功能脚本。
|
|
34
36
|
|
|
35
37
|
Skill与工具分别冻结仓库、完整commit、版本、制品和文件摘要，并核兼容关系。使用已提交推送且可验证的Git分发包；npm可以作为备份，不要求等待中心传播。独立Skill包含所需的使用规范与参考，公共命令和接口说明随独立工具提供；不要求使用者阅读体系研发docs。不能只拷正文或用版本号相同冒充内容一致。
|
|
36
38
|
|
|
@@ -42,12 +44,12 @@ Skill与工具分别冻结仓库、完整commit、版本、制品和文件摘要
|
|
|
42
44
|
|
|
43
45
|
每轮产品迭代评估本批全部未通过项，处理可独立推进部分后交付完整增量。局部测试问题退原测试负责人审查整批同因，不自动退整批；跨批公共缺陷交唯一工具维护者，仅暂停受影响集合。测试交付不替代产品结果，真实回退不能为数字单调而隐藏。
|
|
44
46
|
|
|
45
|
-
用户状态与数字按约定粒度、真实执行状态和产品交付证据更新，不把问题存在称为有人正在研发。后端覆盖方法见[固定边界覆盖规范](
|
|
47
|
+
用户状态与数字按约定粒度、真实执行状态和产品交付证据更新，不把问题存在称为有人正在研发。后端覆盖方法见[固定边界覆盖规范](references/case-coverage.md)，不将其组合方法用于改造Islands小程序端目录。
|
|
46
48
|
|
|
47
49
|
## 决策与收尾
|
|
48
50
|
|
|
49
|
-
按[变更规则](
|
|
51
|
+
按[变更规则](references/changes.md)明确唯一归属和受影响消费者。通用规范进本体系，业务事实与测试回归留业务项目，日志和报告留项目运行区。所有提交、推送、发布遵守对应仓库当前授权，不把本库master研发方式强加业务仓。
|
|
50
52
|
|
|
51
|
-
节点按[简短复盘格式](
|
|
53
|
+
节点按[简短复盘格式](references/task-retrospective.md)反馈输入、耗时、返工及改进依据。Owner核关键路径及自身规划责任，修正有证据的通用缺口，验证新成员能够消费；不能只通知旧成员或追加口号。
|
|
52
54
|
|
|
53
55
|
完成时区分设计、设施、Mock验收、真实联调和生产发布。持久保存必要且唯一的交付证据，清理失效入口；不重复归档缓存、不默认生成下载包，不以编译或数量替代业务正确性。
|
package/package.json
CHANGED
|
@@ -10,14 +10,18 @@
|
|
|
10
10
|
- 在放行并行任务前核清共同入口、真实请求边界、可调用公共接口、工具与规则版本。未决业务选择列出依据供用户决策，不派开放任务靠执行者猜。
|
|
11
11
|
- 按写入冲突决定并行：区域测试在文件和准备接口互不冲突时可并行；同一页面产品实现采用单写者。公共设施、全局索引有唯一维护者，各区域独立文件和分支，集成后以精确版本交接。
|
|
12
12
|
- 产品任务以本轮完整需求和case集合为输入，不指定按目录或case顺序逐一研发。已有工程先运行本轮范围测试，以失败及需求变化定位工作，按共因统一修复；改后验证失败项和受影响的已通过项。单写者仅限制多个产品节点的并发写入，不限制节点内部统筹全部需求。普通case失败不应阻断其他独立case的失败收集，公共设施失效则先修共因。
|
|
13
|
-
- 给执行者实际可访问的规则和工具，不把Owner已读过/Skill源码已改当成成员已获得。工程Skill按已推送Git原包传播并核实际内容；Owner
|
|
13
|
+
- 给执行者实际可访问的规则和工具，不把Owner已读过/Skill源码已改当成成员已获得。工程Skill按已推送Git原包传播并核实际内容；Owner规划规则不必整篇复制给执行者，本轮特有交付目标写入任务，通用交付要求由Skill承载。
|
|
14
14
|
- 任务应有范围内修复权限，普通测试红灯分清产品或设施责任，不因为一次失败就阻塞或新增节点。真正源冲突与缺少不可替代输入才升级。
|
|
15
15
|
|
|
16
16
|
## 新任务继承公共能力，而非依赖旧Agent记忆
|
|
17
17
|
|
|
18
|
-
|
|
18
|
+
Owner先消化上游输入的不确定性：核定源版本，完成必要的编译、协议或目录生成及异常归因，准备实际可取的研发分支和生成物。首个设计阶段也基于明确分支与既定设计范围执行，不承担上游可用性探索。阶段内正常设计与实现判断仍归对应角色。正式交付物进入指定Git分支，运行证据、问题反馈和复盘进入指定共享目录。
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
任务分发只驱动阶段，不再编写一份研发手册。每个节点明确三件事：输入对象及精确版本、使用哪个Skill完成哪个阶段、交付到哪个Git分支或共享目录。存在业务分组时补充具体范围；不同节点可共用一份明确的版本清单，但不能仅写“自行看计划”而省略本节点输入对象。上游尚未完成时，写明所依赖的阶段产物，由检查点交接确认后的精确提交。
|
|
21
|
+
|
|
22
|
+
阶段职责、工具使用策略、门禁、结果判定、交付内容与复盘规则由对应Skill承载；公开命令和参数由工具说明承载。任务只提供这些资料可访问的冻结位置，不复制通用规则或逐条工具命令。Git分支和共享目录是交付承载位置，节点明确实际需要的目标即可，不为每个任务另造交付文件格式。
|
|
23
|
+
|
|
24
|
+
新Agent应能从节点直接找到业务输入、对应Skill和公开工具资料，并依此完成阶段。发现只有任务里的临时指令才能保证正确执行时，区分业务特有约束与通用规范缺口：前者保留在任务，后者修到Skill或工具，不继续堆长节点。
|
|
21
25
|
|
|
22
26
|
消费者先核入口可访问、满足当前交付目标；缺能力时给公共维护者具体缺口和使用场景，不自行复制算法或建立平行报告工具。已有工具即使工作正常，绕过它也属于消费与规划缺陷。Owner交付时核实际执行入口、输入身份和可访问产物，不以版本声明、文件存在或外观相似替代实际消费证据。
|
|
23
27
|
|
|
@@ -35,7 +39,7 @@
|
|
|
35
39
|
|
|
36
40
|
## 节点完成与Owner复盘
|
|
37
41
|
|
|
38
|
-
|
|
42
|
+
阶段交付包含短篇过程复盘，字段见[复盘模板](task-retrospective.md)。报告写任务共享证据区，最终由Owner持久归档，不能混入业务代码仓。无问题可以明确写无，不为模板制造问题。
|
|
39
43
|
|
|
40
44
|
Owner收尾时结合报告和真实执行记录核对：
|
|
41
45
|
- 总历时与关键路径，安装/有效建设/验证/等待/返工分开；并行节点时长不能直接相加当总历时。
|
|
@@ -55,9 +59,9 @@ Owner收尾时结合报告和真实执行记录核对：
|
|
|
55
59
|
|
|
56
60
|
规划要列出“已证问题 → 本轮改变 → 检查证据”，不能只附历史复盘链接。优先处理关键路径：若耗时主要是逐case构建启动，采用经验证的批量并行工具；覆盖编写可以按区域并行，统一产品后由一个验收节点调用工具，不为分区运行重复安排agent。并发度、资源及生命周期验证属于测试设施，具体方法由测试Skill维护。
|
|
57
61
|
|
|
58
|
-
交接使用小型摘要加独立明细引用：唯一SHA、范围原ID、case manifest
|
|
62
|
+
交接使用小型摘要加独立明细引用：唯一SHA、范围原ID、case manifest、准备接口与精确工作目录；运行原件不要多层重复嵌入。公开工具说明提供最小可运行用法，节点只交接其冻结位置，消费者不靠命名猜接口。原始完整输入仍保留，摘要不能删掉字段来源与边界。
|
|
59
63
|
|
|
60
|
-
|
|
64
|
+
冻结输入、兼容旧定义、依赖复用、失败共因归并及报告规则由本Skill及工具合同统一承载，任务仅声明本轮输入和交付目标。节点复盘核对是否还有源码漂移补跑、重复安装、输入截断补读和不必要串行等待；没有计时证据时不编造收益。通用规则发布并验证实际安装后再交消费者，本轮具体SHA和路径留在任务输入，不写死进通用Skill。
|
|
61
65
|
|
|
62
66
|
## 在研发前发现接入问题
|
|
63
67
|
|