refactor: 精简配置文档和项目说明
This commit is contained in:
81
AGENTS.md
81
AGENTS.md
@@ -59,28 +59,7 @@
|
||||
|
||||
---
|
||||
|
||||
## 4. 开发规范
|
||||
|
||||
### Git 提交
|
||||
- 遵循 [Conventional Commits](https://www.conventionalcommits.org/)
|
||||
- 格式:`<type>(<scope>): <subject>`(中文)
|
||||
- 类型:feat、fix、docs、style、refactor、test、chore、ci、build、perf
|
||||
- 主分支:`main`
|
||||
|
||||
详见 `skill/git/SKILL.md`
|
||||
|
||||
### 代码风格(JavaScript/TypeScript)
|
||||
- 缩进:2 空格
|
||||
- 分号:使用
|
||||
- 引号:双引号
|
||||
- 命名:camelCase、PascalCase、UPPER_SNAKE_CASE
|
||||
|
||||
### 分支命名
|
||||
- `feature/描述`、`fix/描述`、`docs/描述`
|
||||
|
||||
---
|
||||
|
||||
## 5. 批量修改策略
|
||||
## 4. 批量修改策略
|
||||
|
||||
**原则:先修改一个,验证通过后再批量修改**
|
||||
|
||||
@@ -89,7 +68,6 @@
|
||||
2. 修改样本
|
||||
3. 验证功能
|
||||
4. 批量应用
|
||||
5. 最终验证
|
||||
|
||||
### 例外
|
||||
- 简单修改(如批量重命名)
|
||||
@@ -98,60 +76,13 @@
|
||||
|
||||
---
|
||||
|
||||
## 6. 工具使用策略
|
||||
## 5. 代码质量
|
||||
|
||||
| 工具 | 用途 |
|
||||
|------|------|
|
||||
| **Task** | 探索代码库、多步骤分析、全局搜索 |
|
||||
| **Bash** | Git 操作、构建、测试命令 |
|
||||
| **Read/Edit/Write** | 文件读写(不用 cat/sed/echo) |
|
||||
| **Glob/Grep** | 文件查找和内容搜索 |
|
||||
| **TodoWrite** | 任务管理(超过 3 步必须使用) |
|
||||
|
||||
---
|
||||
|
||||
## 7. 任务管理
|
||||
|
||||
### TodoWrite 使用原则
|
||||
- 任务超过 3 步时创建 todo 列表
|
||||
- 立即标记完成(不批量完成)
|
||||
- 同时只有 1 个 `in_progress`
|
||||
|
||||
### 状态
|
||||
- `pending`、`in_progress`、`completed`、`cancelled`
|
||||
|
||||
---
|
||||
|
||||
## 8. 代码质量
|
||||
|
||||
### 测试
|
||||
- 新功能必须包含测试
|
||||
- 覆盖率 ≥ 50%
|
||||
|
||||
### 构建
|
||||
### 原则
|
||||
- 确保程序能够运行,需要用户手动运行的除外
|
||||
- 类型检查零错误
|
||||
- 修复所有 Linter 警告
|
||||
- 尝试修复所有 Linter 警告
|
||||
- 允许存在 warning,但不允许存在 error
|
||||
|
||||
### 安全
|
||||
- 不提交敏感信息(.env、密钥)
|
||||
- 输入验证和输出编码
|
||||
|
||||
---
|
||||
|
||||
## 快速参考
|
||||
|
||||
| 场景 | 操作 |
|
||||
|------|------|
|
||||
| 用户说"创建文件" | 创建文件,**不自动提交** |
|
||||
| 用户说"提交代码" | 可以执行 `git commit` |
|
||||
| 用户使用 `/git-push` | 执行完整推送流程 |
|
||||
| 创建超过 100 行的文件 | 只说明路径和用途,**不展示内容** |
|
||||
| 命令输出已完整 | 直接展示,**不重复总结** |
|
||||
| 批量修改 10 个文件 | 先改 1 个验证,再批量 |
|
||||
|
||||
---
|
||||
|
||||
详细指南:
|
||||
- Git 工作流:`skill/git/SKILL.md`
|
||||
- Gitea 集成:`skill/gitea/SKILL.md`
|
||||
- 开发规范:各 `skill/*/SKILL.md`
|
||||
|
||||
Reference in New Issue
Block a user