| name | archi-data-sync |
| description | Sync data governance files with protocol outputs. Must run in isolated context/subagent. Protocol-invoked only; do not auto-trigger from casual user requests. |
| disable-model-invocation | true |
调用方式
- 自动调用: 否,不由模型根据 description 自行触发。
- 触发位置: 仅由
/archi.* 协议中的 [[SUBAGENT]] / [[NO-SUBAGENT]] 显式调用。
- 执行上下文: 支持 subagent 时必须在独立子代理/独立上下文执行;无 subagent 时才降级为内联 Skill。
- 边界: 只返回协议要求的结构化产物,后续写入、确认和签收由调用协议负责。
数据治理同步执行器
同步矩阵
| 文件 | 同步内容 | 触发条件 |
|---|
map.json | directoryMapping / logicalTopology / featureRelations | 新增代码模块或目录 |
dictionary.json | 新业务实体 / 动作 / 共享工具 / 公共组件 | 产出出现未登记的业务术语或工具 |
error_codes.json | 新业务错误码 | 产出出现未注册的错误场景 |
env_registry.json | 新环境变量 | 产出引入新 process.env.X |
| [[WHEN: ui | | ui |
| [[WHEN: ui | | ui |
| [[WHEN: data | | data |
| [[WHEN: api | | api |
| [[WHEN: cli | | cli |
| [[WHEN: lib | | lib |
执行协议
- 按
project_features 加载对应的 global_files(固定四件 + feature 匹配项)
- 扫描
agent_output 每项,按 type 分流到矩阵对应的结果桶里
- 每项变更:
- 对比现有条目查重;完全重复 → 跳过;部分重复 → 合并
- 经「边界检查」:命中框架概念黑名单 → 跳过并在 Diff 中标
SKIPPED (framework)
- 被移除的条目不删除,仅记录 MODIFIED
- 汇总成
writes,每项含 file / op(append / merge)/ path(JSON 路径)/ value
- 输出 Diff +
writes
硬边界
- 禁注册框架概念:
scripts / scaffold / roadmap / plan / protocol / skill / architext.* 等 Architext 自身概念不入项目全局文件
- 禁修改
00_system.md:本 skill 是规则执行者,非制定者
- 禁删除:仅追加 / 合并;移除的条目由
/archi.remove 的 cleanup 路径处理
输出格式
### Data Sync Results
ADDED:
- <file>: <path> += <value 摘要>
MODIFIED:
- <file>: <path> 扩展 <新增字段摘要>
SKIPPED:
- <file>: <path> — <跳过原因(duplicate / framework)>
Summary: <X> files changed / <Y> added / <Z> modified / <W> skipped
writes:
- file: <file>
op: <append|merge>
path: <JSON 路径>
value: <具体值>
无变更时仅输出:### Data Sync Results — NO CHANGES
输出验证