 tao.chenandClaude
|
210aeb1315
|
docs: CLAUDE.md 补 project-specific 工作流校准
~/.claude/CLAUDE.md 已经定义 Codex-first 路由、Codex MCP 强制参数、
Linus 三问、4-phase 工作流、prompt 模板、auto-confirm/pause 边界。本
文件不重复这些全局规则, 只加项目级校准:
- 路由表: 用本仓库实际任务举例 (GIN_MODE 接线 / loadDotenv 新增 /
S1017 修 / .gitignore 行 / CLAUDE.md 自身 / 注释 typo / .env.example
标题), 给出"trivial 阈值"在本项目的具体判据
- Codebase 模式: 指向 internal/httpclient/redirect_test.go (httptest
+ "127.0.0.1" 白名单), internal/logging/tool_call_test.go
(bytes.Buffer + slog.NewJSONHandler 捕获), internal/mcp/tools/
目录约定, 让未来 agent 进包前先读已有测试文件
- 预提交检查 (项目级): 强调 deferred-behavior test 是 gap-locking
不是回归, 公共签名变更必须在 commit body 解释兼容性
- commit 消息规约: 从 git log 实际样本里抽出 <package>: 中文动词
开头 + body 回答"gap / fix / 风险 / 锁定测试" + Co-Authored-By
- 项目坑: .env 不透明 / internal/ Go 强制 / multiHandler 双写
(新事件 = 一次 base.Info 调用) / TestDoWithRedirect_DeferredRFC9110Gaps
是 gap 测试不是 bug 报告
仅改 CLAUDE.md, 0 代码变更, 无需 build/test 验证.
Co-Authored-By: Claude <noreply@anthropic.com>
|
2026-07-13 18:14:40 +08:00 |
|
|
tao.chenandClaude
|
a4e2472716
|
Phase 0+1+2 续: 项目骨架 + 配置 + 日志 + 存储层
Phase 0 (项目骨架):
- main.go 改为最小骨架 (config + logging + gin + /healthz + 优雅退出)
- internal/{config,logging,storage,cluster,...}/ 目录占位
Phase 1 (配置 + 日志):
- internal/config: env 解析 + 必填校验 + token 隐藏的 String()
- internal/logging: slog multi-handler 双输出 (终端 text + 主文件 JSON)
+ StartToolCall per-tool 独立文件 (0600), tools 目录 0700
Phase 2 续 (存储层):
- internal/cluster: 16 字段 Cluster struct (AuthPassword json:"-")
- internal/storage: modernc.org/sqlite 接入, WAL 模式, schema 自动迁移
- ClusterRepo CRUD: Create/Get/List/Update/Delete + ErrNotFound
+ AuthPassword 空字符串 = 保留旧密码 (核心约定)
- 7 个单元测试全绿 (:memory: DB)
- created_at/updated_at 改纳秒精度, 消除 List 测试的 sleep 特殊 case
Co-Authored-By: Claude <noreply@anthropic.com>
|
2026-07-10 12:12:53 +08:00 |
|