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。

