Skip to content

Latest commit

 

History

History
43 lines (27 loc) · 1.46 KB

AGENTS.md

File metadata and controls

43 lines (27 loc) · 1.46 KB

AGETNS for AI

重要 优先使用中文回复和响应,除非明确要求英文回复

  • 如果当前任务有进度跟进文件 or 计划文件,需要在完成后更新 checklist
  • 多阶段任务,需要在每个阶段完成后更新进度并提交 Git 提交
  • CLI 层尽量只做参数解析、输出格式、错误返回;业务编排优先下沉到 internal/app/* service。
  • 完成涉及 MVP 主链路的改动后,至少运行 go test ./... 再宣称完成。
  • 如果有设计或开发方案,需要整理输出到 docs 目录下
  • 当前正在进行 v0 版本开发,因此,只要确认进行调整的无需保留兼容处理。

正在进行的工作

IMPORTANT: 需要实时更新,正在进行的工作和关键md文档链接;已完成的需要移除,不能一直累计,总数不能超过10条。

开发规范

  • 使用 git worktree 进行开发时,在 .worktrees 目录下创建分支
  • 关键的方法或逻辑点需要添加注释说明

Go单元测试编写

  • 使用 github.com/gookit/goutil/testutil/assert 断言结果
  • 同一个方法的多个用例使用 t.Run() 包裹

require 断言结果的写法:

Require(t, assert.Eq(t, 1, res.ID))

// Standard assertion
assert.Eq(t, expected, actual)

gcli 使用

  • gcli.Command 的 Func 方法的第二个参数是解析后剩余的参数,一般不会直接使用

项目核心记忆