EXTEND

插件开发

在不改动框架的前提下,为 Gtstitch 增加一个新的垂直能力。

Gtstitch 奉行 plugin-first:所有垂直能力都以插件形式 additive 挂载, 产品层与框架层零改动。新增一个 @gtstitch/* 插件的标准流程如下。

1. 建包骨架

在 packages/<tier>/<name>/ 下建立 package.json、 tsconfig.json、src/index.ts,名称统一为 @gtstitch/dsh-<name>。

2. 声明 persona 与工具挂载

在 preset 的 agent.cordis.yml 中注册 persona 与工具行, 工具挂载受 persona-boundary 约束,并由 verify-persona-mount-matrix.mjs 校验。

3. 过门禁

  • 接线完整性守卫(新增工具必须被某个 persona 消费)
  • persona 挂载矩阵校验
  • 不变式陪伴文件(invariant companions)
  • typecheck + 测试覆盖率门禁

4. 补 README 与 i18n

按 PLUGIN_DEV_GUIDE.md 的模板补齐中英文 README 与 README.i18n.yaml。

5. 登记上游同步保护

新增的自有资产须登记进 upstream-overrides.json,避免被上游同步抹掉。

完整实操手册见仓库内 gtstitch/docs/PLUGIN_DEV_GUIDE.md。