From 9b4ba33dfe3c208509934174c6c1554a978ec54a Mon Sep 17 00:00:00 2001 From: wei <104672881+shengzhaowei@users.noreply.github.com> Date: Sat, 21 Nov 2026 13:08:36 +0800 Subject: [PATCH] docs(local): add read-only, audit and row-level rules to SQL profile --- local/skills/devflow/rules/profiles/sql.md | 5 +++++ local/skills/devflow/tests/test_regressions.py | 11 +++++++++++ 2 files changed, 16 insertions(+) diff --git a/local/skills/devflow/rules/profiles/sql.md b/local/skills/devflow/rules/profiles/sql.md index cd4843a82..4001f5f5a 100644 --- a/local/skills/devflow/rules/profiles/sql.md +++ b/local/skills/devflow/rules/profiles/sql.md @@ -5,3 +5,8 @@ 3. 事务范围保持最小,明确提交、回滚、超时和失败重试语义;事务内外部调用或跨资源一致性必须说明风险。 4. 迁移必须考虑向前兼容、存量数据、重复执行、灰度期间的新旧版本共存以及可执行回滚;破坏性操作需要显式风险与恢复方案。 5. 审查和测试覆盖约束、空值、重复数据、并发写入、失败回滚及敏感数据处理;只依据实际 schema、查询和执行证据下结论。 +6. 只读优先:查询默认只读;写操作必须先说明必要性、影响范围和回滚方案,未确认写意图前不得执行 INSERT、UPDATE、DELETE 或 DDL。 +7. 行数与超时上限:查询必须有按项目约定的行数上限和超时,禁止无界读取;超限先收敛条件再执行,不得先全量拉回再过滤。 +8. 审计:所有写操作和敏感查询必须留审计记录(谁、何时、哪条语句、影响行数),审计记录只追加不改写;只读查询的审计范围按敏感度定。 +9. 行级权限:涉及多租户、多组织或多范围的数据,必须先确认行级隔离条件,不得假设调用者只能看到自己的数据;缺隔离条件就 fail-closed,停在当前阶段。 +10. 敏感数据:密码、密钥、身份证号、手机号等敏感字段不得明文输出到日志、产物或审计记录,必要时只留脱敏形式;导出敏感数据须先确认授权。 diff --git a/local/skills/devflow/tests/test_regressions.py b/local/skills/devflow/tests/test_regressions.py index 7794cc143..5fc2d27d7 100644 --- a/local/skills/devflow/tests/test_regressions.py +++ b/local/skills/devflow/tests/test_regressions.py @@ -368,6 +368,17 @@ def test_codebuddy_adapter_requires_team_member_dispatch(self): self.assertIn("cleanup_team.py", adapter) self.assertIn("不得读取 Team 配置、成员、inbox 或状态", adapter) + def test_sql_profile_documents_readonly_audit_and_row_level_rules(self): + rules = (SKILL_ROOT / "rules/profiles/sql.md").read_text(encoding="utf-8") + self.assertIn("只读优先", rules) + self.assertIn("未确认写意图前不得执行 INSERT、UPDATE、DELETE 或 DDL", rules) + self.assertIn("行数上限和超时", rules) + self.assertIn("禁止无界读取", rules) + self.assertIn("审计记录只追加不改写", rules) + self.assertIn("行级隔离条件", rules) + self.assertIn("缺隔离条件就 fail-closed", rules) + self.assertIn("不得明文输出到日志、产物或审计记录", rules) + def fill_stage_artifacts(self, state_path, stage): state = json.loads(state_path.read_text(encoding="utf-8")) artifact_root = Path(state["artifacts_dir"])