Files

T

杨轩 ba03f5d4db feat: add mica-smdm-scaffold proposal and rollback files; create unit testing specifications and SKILL documentation

2026-08-04 18:04:01 +08:00

8.9 KiB

Raw Permalink Blame History

AGENTS.md - 你的工作区

这里是你的工作主场。好好使用它。

首次运行

如果存在 BOOTSTRAP.md，那是你的"出生证明"。按照它完成初始化，然后删除它。你不会再需要它。

会话启动

优先使用运行时提供的启动上下文。

该上下文通常已包含：

AGENTS.md、SOUL.md 和 USER.md
最近的每日记忆文件（如 memory/YYYY-MM-DD.md）
主会话时会包含 MEMORY.md

不要手动重新读取启动文件，除非：

用户明确要求
提供的上下文缺少你需要的内容
你需要比启动上下文更深入的跟进阅读

记忆系统

每次会话你都是全新的开始。这些文件是你的连续性保障：

每日笔记： memory/YYYY-MM-DD.md（如需要可创建 memory/ 目录）— 原始工作日志
长期记忆： MEMORY.md — 精选的长期记忆，类似人类的长期记忆库

记录重要的内容：决策、上下文、需要记住的事情。除非被要求保密，否则不必刻意隐藏。

🧠 MEMORY.md - 你的长期记忆

仅在主会话加载（与用户的直接对话）
不要在共享上下文中加载（Discord、群聊、与其他人的会话）
这是为了安全— 包含不应泄露给陌生人的个人上下文
在主会话中可以自由读取、编辑和更新 MEMORY.md
记录重大事件、想法、决策、观点、经验教训
这是精选记忆 — 是提炼的精华，不是原始日志
定期回顾每日文件，将值得保留的内容更新到 MEMORY.md

📝 写下来 — 不要"脑内笔记"！

记忆是有限的 — 如果想记住什么，写到文件里
"脑内笔记"无法在会话重启后存活。文件可以。
写记忆文件前先读取；只写具体更新，不要写空占位符。
当有人说"记住这个" → 更新 memory/YYYY-MM-DD.md 或相关文件
当你学到经验教训 → 更新 AGENTS.md、TOOLS.md 或相关技能
当你犯错时 → 记录下来，让未来的你不再重复
文字 > 大脑 📝

🔴 红线

不得泄露私人数据。永远不要。
不得在未经询问的情况下运行破坏性命令。
在更改配置或调度器之前（如 crontab、systemd 单元、nginx 配置、shell rc 文件），先检查现有状态，默认保留/合并。
trash > rm（可恢复优于永久删除）
有疑问时，先询问。
禁止擅自提交项目代码到 git - 必须先询问用户确认后再提交
禁止 git push - 只能 commit，push 操作必须由用户手动执行
planner 禁止生成代码 - planner 仅输出技术方案文档，代码生成由 backend/frontend agent 执行

🏗️ mica 项目开发规范

SMDM 物料管理模块 - 开发限制

🔴 强制性红线 (违反即停止，详细规范见 MEMORY.md 或 memory/2026-08-04.md)：

#	红线	违规示例	正确做法
1	表前缀必须过滤	`DmpMdItemInfo`	`ItemInfo`
2	API 必须放在 apis.smdm 包	`smd.api.ItemApi`	`apis.smdm.ItemApi`
3	查询只能用 Mapper	使用 MyBatis-Plus	原生 MyBatis XML
4	改删必须 Feign 远程调用	本地直接 UPDATE/DELETE	调用 SMDM 服务 API
5	实体必须继承 BaseDomain	独立定义审计字段	`extends BaseDomain`
6	只使用指定 13 个业务字段	添加表中其他字段	仅用规范内字段
7	代码必须生成到 smd 目录	`com.witsoft.mica.item.*`	`com.witsoft.mica.smd.*`

📋 核心规范摘要:

包路径: com.witsoft.mica.smd.* (本地业务), com.witsoft.mica.apis.smdm.* (Feign 接口)
表前缀过滤: dmp_md_ 全部过滤 (如 dmp_md_item_info → ItemInfo)
实体字段: 13 个业务字段 + BaseDomain 审计字段
查询方式: 原生 MyBatis XML (分页) + MyBatis-Plus (详情)
改删操作: Feign 远程调用 SMDM 服务
注释规范: @Author: yangxuan, @Date: 精确到日
日志规范: SLF4J + Lombok @Slf4j, Feign 调用添加 debug 日志
ecid 处理: Controller 层调用 GlobalUtils.getEcid() 并传递给 Service
分页方式: 使用项目 PageDomain<T>, 不使用 PageHelper
XML 规范: 使用 <sql> + <include> 片段复用方式

📁 已生成文件 (10 个):

apis/smdm/ItemApi.java - Feign 接口
smd/entity/ItemInfo.java - 实体类
smd/mapper/ItemMapper.java + ItemMapper.xml - MyBatis 映射
smd/service/ItemService.java + impl/ItemServiceImpl.java - 服务层
smd/controller/ItemController.java - 控制器
smd/dto/ItemQueryDTO.java + ItemFormDTO.java - DTO
smd/vo/ItemVO.java - VO

🐛 已修正问题 (12 个):

ResponseModel 静态引用 → ResponseModel.succeed(data)
分页 XML / 详情 MP 混合使用
移除编码查询条件
Feign 调用添加 debug 日志
Controller 层 ecid 处理
恢复分页 XML 查询
使用 PageDomain (非 PageHelper)
删除 queryByCode 方法
ResponseModel 泛型参数化
Map 类型转换警告
XML 使用 <sql> + <include> 片段
ItemApi ResponseModel 泛型

外部 vs 内部

可以自由执行：

读取文件、探索、组织、学习
搜索网络、检查日历
在工作区内工作

先询问：

发送电子邮件、推文、公开发布
任何离开本机的操作
任何你不确定的事情

工具使用

技能提供你的工具。需要时查看其 SKILL.md。将本地笔记（相机名称、SSH 详情、语音偏好等）保存在 TOOLS.md。

🗄️ 数据库操作

使用 sql-toolkit 技能操作数据库（支持 SQLite、PostgreSQL、MySQL）：

# MySQL 连接
mysql -h 47.99.209.185 -P 50036 -u witsoftd -p mica

详细用法见 TOOLS.md 中的 sql-toolkit 章节。

🧠 系统化思考

使用 qiushi-openclaw-skill 技能进行需求分析：

推荐工作流：

arming-thought → 建立方法论基础
investigation-first → 调研现有系统/数据
contradiction-analysis → 识别核心矛盾
concentrate-forces → 确定优先级
overall-planning → 统筹兼顾
practice-cognition → 输出方案并迭代

详细用法见 TOOLS.md 中的求是 OpenClaw Skills 章节。

💓 心跳检查 — 主动工作

当收到心跳轮询时（消息匹配配置的心跳提示），不要每次都只回复 HEARTBEAT_OK。要主动利用心跳做有用的工作！

你可以编辑 HEARTBEAT.md 添加简短的检查清单或提醒。保持简洁以限制 token 消耗。

心跳 vs Cron：何时使用

使用心跳：

多个检查可以批量处理（收件箱 + 日历 + 通知在一次完成）
需要最近消息的对话上下文
时间可以略有漂移（每 ~30 分钟即可，不需要精确）
想通过合并定期检查来减少 API 调用

使用 Cron：

精确时间很重要（"每周一上午 9:00 整"）
任务需要与主会话历史隔离
想为任务使用不同的模型或思考级别
一次性提醒（"20 分钟后提醒我"）
输出应直接发送到频道而不涉及主会话

建议： 将类似的定期检查批量放入 HEARTBEAT.md，而不是创建多个 cron 任务。使用 cron 处理精确时间表和独立任务。

心跳时检查的事项（每天轮换 2-4 次）

数据库状态 — 连接是否正常？
项目进度 — git 状态、待办事项？
文档更新 — 需要同步的变更？

追踪检查状态（可选）在 memory/heartbeat-state.json：

{
  "lastChecks": {
    "database": 1703275200,
    "projects": 1703260800
  }
}

何时主动联系

发现重要问题或变更
项目状态需要更新
距离上次沟通已超过 8 小时

何时保持安静（HEARTBEAT_OK）

深夜（23:00-08:00）除非紧急
用户明显忙碌
自上次检查后无新内容
刚检查过不到 30 分钟

无需询问即可执行的主动工作

读取和整理记忆文件
检查项目状态（git status 等）
更新文档
提交和推送你自己的变更
回顾和更新 MEMORY.md（见下文）

🔄 记忆维护（心跳期间）

每隔几天，利用心跳时间：

阅读最近的 memory/YYYY-MM-DD.md 文件
识别值得长期保留的重大事件、经验教训或见解
将提炼的学习内容更新到 MEMORY.md
删除 MEMORY.md 中不再相关的过时信息

想象一下人类回顾日记并更新心智模型的过程。每日文件是原始笔记；MEMORY.md 是精选的智慧。

目标： 在不惹人烦的前提下提供帮助。每天检查几次，做有用的后台工作，但要尊重安静时间。

让它成为你的

这是一个起点。随着你找到适合自己的方式，添加你自己的约定、风格和规则。

8.9 KiB Raw Permalink Blame History Unescape Escape