Files

Neo 8228b3fa37 chore: migrate IDE environment from Kiro to Claude Code

- Add CLAUDE.md (root + ETL subdirectory + db subdirectory) consolidating all Kiro steering docs
- Add .mcp.json migrated from .kiro/settings/mcp.json (test DBs enabled, prod disabled)
- Add .claude/commands/ (audit, doc-sync, db-docs) replacing Kiro skills
- Add .claude/hooks/ (session_start, post_edit_audit, stop_audit_check) replacing Kiro hooks
- Add .claude/settings.json registering all hooks
- Add scripts/audit/prescan.py merging Kiro's audit_flagger + compliance_prescan
- Remove .kiro/agents, hooks, scripts, settings, skills, state (migrated or obsolete)
- Update .gitignore for Claude Code

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-04-05 15:48:08 +08:00

2.0 KiB

Raw Blame History

/doc-sync — 逻辑改动后文档同步

检查本次会话中的逻辑改动是否需要同步更新文档，并执行同步。

触发条件

修改了以下任一类内容时应执行：

业务规则/计算口径/资金处理（精度、舍入、阈值）
ETL/SQL 清洗聚合映射逻辑
API 行为（返回结构、错误码、鉴权/权限）
小程序关键交互流程
数据库表结构

执行步骤

第 1 步：分类

判断本次会话的改动是否属于"逻辑改动"。如果只是纯格式化/拼写修正/注释调整，告知用户"无逻辑改动，无需文档同步"并结束。

第 2 步：逐项评估需要更新的文档

根据变更涉及的模块，评估以下文档是否需要更新：

各级 README.md（只更新与本次变更相关的）：

README.md（根目录）：项目总览、快速开始、环境变量、架构概述
apps/backend/README.md：后端 API 路由、配置、运行方式
apps/etl/connectors/feiqiu/README.md：ETL 任务清单、开发约定
apps/miniprogram/README.md：小程序页面结构
apps/admin-web/README.md：管理后台功能说明
apps/tenant-admin/README.md：租户管理后台功能说明
packages/shared/README.md：共享包说明
db/README.md：Schema 约定、迁移规范

规则：如果"对读者理解系统行为有帮助"就应更新。若某个 README 尚不存在但变更涉及该模块，应创建。

第 3 步：执行更新

对每个需要更新的文档：

读取当前内容
根据本次变更更新相关段落
写入更新后的内容

如果更新工作量大（>3 个文档），委托子代理处理。

第 4 步：联动检查

如果涉及 DB schema 变化：提醒用户执行 /db-docs
如果涉及 API 变化：检查 apps/backend/docs/API-REFERENCE.md 是否已更新

第 5 步：输出摘要

Changed：改了哪些文档
Why：原始原因 + 直接原因
Risk：风险点与回归范围
Verify：建议的验证步骤

2.0 KiB Raw Blame History Unescape Escape