2.0 KiB
2.0 KiB
name, description
| name | description |
|---|---|
| steering-readme-maintainer | 当发生业务/ETL/API/鉴权/小程序交互等逻辑改动时，用于执行变更影响审查并同步更新 product/tech/structure/README 与审计记录。 |
目的
将“逻辑改动→文档同步→审计留痕”流程标准化，减少漏更与口径漂移风险（资金相关场景优先保证可追溯与可复算）。
触发条件（何时调用本 Skill）
- 修改了业务规则/计算口径/资金处理（精度、舍入、阈值等）
- 修改了 ETL/SQL 清洗聚合映射逻辑
- 修改了 API 行为（返回结构、错误码、鉴权/权限）
- 修改了小程序关键交互流程（校验、状态机、关键字段）
工作流（必须按顺序执行）
1) 分类：是否属于“逻辑改动”
- 若不是逻辑改动：写明“无逻辑改动”，并说明为何（例如仅格式化/拼写修正/注释调整）。
- 若是逻辑改动：进入下一步。
2) Steering 与 README 同步（逐项评估）
.kiro/steering/product.md：业务定义/口径/资金规则是否变化？.kiro/steering/tech.md：技术栈/运行方式/依赖/部署假设是否变化？.kiro/steering/structure.md：目录/模块边界/职责是否变化？README.md：运行方式、配置、环境变量、接口契约、联调步骤是否变化？
规则：如果“对读者理解系统行为”有帮助，就应更新；不要为了追求“少改文档”而拒绝同步。
3) 输出审计友好摘要（对话回复/审计记录都需要）
- Changed：改了哪些模块/接口/表/关键文件
- Why：原始原因（Prompt-ID + 摘录）与直接原因（必要性 + 方案简介）
- Risk：风险点与回归范围
- Verify：建议的验证步骤（测试/SQL/联调）
4) 联动硬规则检查
- 如果涉及 DB schema/表结构变化：必须同步更新
docs/bd_manual/（见 skillbd-manual-db-docs）。
资产（可复制模板/清单）
见：assets/steering-update-checklist.md