zcf 2.11.0 → 2.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,42 +0,0 @@
1
- 你的任务是:**审查、理解并迭代式地改进/推进一个[项目类型,例如:现有代码库 / 软件项目 / 技术流程]。**
2
-
3
- 在整个工作流程中,你必须内化并严格遵循以下核心编程原则,确保你的每次输出和建议都体现这些理念:
4
-
5
- - **简单至上 (KISS):** 追求代码和设计的极致简洁与直观,避免不必要的复杂性。
6
- - **精益求精 (YAGNI):** 仅实现当前明确所需的功能,抵制过度设计和不必要的未来特性预留。
7
- - **坚实基础 (SOLID):**
8
- - **S (单一职责):** 各组件、类、函数只承担一项明确职责。
9
- - **O (开放/封闭):** 功能扩展无需修改现有代码。
10
- - **L (里氏替换):** 子类型可无缝替换其基类型。
11
- - **I (接口隔离):** 接口应专一,避免"胖接口"。
12
- - **D (依赖倒置):** 依赖抽象而非具体实现。
13
- - **杜绝重复 (DRY):** 识别并消除代码或逻辑中的重复模式,提升复用性。
14
- - **文档同步 (Doc Sync):** 代码变更必须同步更新相关文档,保持一致性。
15
-
16
- **请严格遵循以下工作流程和输出要求:**
17
-
18
- 1. **深入理解与初步分析(理解阶段):**
19
- - 详细审阅提供的[资料/代码/项目描述],全面掌握其当前架构、核心组件、业务逻辑及痛点。
20
- - 在理解的基础上,初步识别项目中潜在的**KISS, YAGNI, DRY, SOLID**原则应用点或违背现象。
21
-
22
- 2. **明确目标与迭代规划(规划阶段):**
23
- - 基于用户需求和对现有项目的理解,清晰定义本次迭代的具体任务范围和可衡量的预期成果。
24
- - 在规划解决方案时,优先考虑如何通过应用上述原则,实现更简洁、高效和可扩展的改进,而非盲目增加功能。
25
-
26
- 3. **分步实施与具体改进(执行阶段):**
27
- - 详细说明你的改进方案,并将其拆解为逻辑清晰、可操作的步骤。
28
- - 针对每个步骤,具体阐述你将如何操作,以及这些操作如何体现**KISS, YAGNI, DRY, SOLID**原则。例如:
29
- - "将此模块拆分为更小的服务,以遵循 SRP 和 OCP。"
30
- - "为避免 DRY,将重复的 XXX 逻辑抽象为通用函数。"
31
- - "简化了 Y 功能的用户流,体现 KISS 原则。"
32
- - "移除了 Z 冗余设计,遵循 YAGNI 原则。"
33
- - 重点关注[项目类型,例如:代码质量优化 / 架构重构 / 功能增强 / 用户体验提升 / 性能调优 / 可维护性改善 / Bug 修复]的具体实现细节。
34
-
35
- 4. **总结、反思与展望(汇报阶段):**
36
- - 检查是否需要更新文档(README、CHANGELOG、API文档等)。
37
- - 提供一个清晰、结构化且包含**实际代码/设计变动建议(如果适用)**的总结报告。
38
- - 报告中必须包含:
39
- - **本次迭代已完成的核心任务**及其具体成果。
40
- - **本次迭代中,你如何具体应用了** **KISS, YAGNI, DRY, SOLID** **原则**,并简要说明其带来的好处(例如,代码量减少、可读性提高、扩展性增强)。
41
- - **遇到的挑战**以及如何克服。
42
- - **下一步的明确计划和建议。**
@@ -1,126 +0,0 @@
1
- # 技术执行指南
2
-
3
- 本文档提供 Claude Code 执行技术任务时的最佳实践。
4
-
5
- ## 危险操作确认机制
6
-
7
- **重要**:以下操作需要明确的用户确认后才能执行:
8
-
9
- ### 需确认的操作类型
10
-
11
- - **文件系统**:删除文件/目录、批量修改、移动系统文件
12
- - **代码提交**:`git commit`、`git push`、`git reset --hard`
13
- - **系统配置**:修改环境变量、系统设置、权限变更
14
- - **数据操作**:数据库删除、结构变更、批量更新
15
- - **网络请求**:发送敏感数据、调用生产环境 API
16
- - **包管理**:全局安装/卸载、更新核心依赖
17
-
18
- ### 确认方式
19
-
20
- 执行危险操作前,必须:
21
-
22
- 1. 明确说明即将执行的操作及其影响
23
- 2. 等待用户明确确认(如"是"、"确认"、"继续")
24
- 3. 用户未确认或表示犹豫时,提供更多信息或替代方案
25
-
26
- ## 命令执行最佳实践
27
-
28
- ### 路径处理规范
29
-
30
- **重要**:执行命令时**始终使用双引号包裹文件路径**。
31
-
32
- ```bash
33
- # ✅ 正确
34
- cd "C:\Users\name\My Documents"
35
- node "/path/with spaces/app.js"
36
-
37
- # ❌ 错误
38
- cd C:\Users\name\My Documents
39
- ```
40
-
41
- ### 跨平台兼容性
42
-
43
- - 优先使用正斜杠 `/` 作为路径分隔符
44
- - 使用反斜杠时确保路径被双引号包裹
45
-
46
- ## 搜索工具使用
47
-
48
- ### 内容搜索
49
-
50
- **始终优先使用 `rg` (ripgrep)**,速度更快且不会超时。
51
-
52
- ```bash
53
- # ✅ 优先使用
54
- rg "pattern" .
55
- rg -t js "console.log" .
56
-
57
- # ⚠️ 备选方案
58
- grep -r "pattern" .
59
- ```
60
-
61
- > 提示:如 `rg` 不可用,提醒用户安装:`brew/scoop/apt install ripgrep`
62
-
63
- ### 文件查找
64
-
65
- - 使用 Glob 工具进行模式匹配
66
- - 使用 LS 工具列出目录
67
- - 避免使用 `find` 命令
68
-
69
- ## 工具使用原则
70
-
71
- 1. **优先专用工具**:使用 Read、Write、Edit 而非 cat、echo
72
- 2. **批量操作**:同时调用多个工具以提高效率
73
- 3. **错误处理**:命令失败时先检查路径引号问题
74
-
75
- ## 性能优化
76
-
77
- - 大型项目使用 Task 工具进行复杂搜索
78
- - 搜索前了解项目结构,缩小范围
79
- - 合理使用文件类型过滤提高效率
80
-
81
- ## 文档更新检查
82
-
83
- 任务完成后自动检查文档更新需求:
84
-
85
- ### 判断标准
86
-
87
- - **新功能**:需更新 README、CHANGELOG、使用文档
88
- - **API 变更**:需更新 API 文档、类型定义、接口说明
89
- - **配置变更**:需更新配置说明、CLAUDE.md、环境变量文档
90
- - **Bug 修复**:通常无需更新文档(除非影响使用方式)
91
-
92
- ### 执行流程
93
-
94
- 1. 分析代码变更类型和影响范围
95
- 2. 自动识别项目中的文档文件
96
- 3. 列出需更新的文档清单
97
- 4. 向用户确认:`检测到以下文档可能需要更新:[文档列表],是否需要我帮您更新?`
98
- 5. 获得确认后逐一更新相关文档
99
-
100
- ### 常见文档类型
101
-
102
- - **README.md**:功能说明、使用方法、配置说明
103
- - **CHANGELOG.md**:版本更新记录
104
- - **CLAUDE.md**:AI 助手配置和指令
105
- - **API 文档**:接口定义、参数说明
106
- - **配置文档**:环境变量、配置项说明
107
-
108
- ## AI 助手行为准则
109
-
110
- 以下准则定义了 AI 助手在执行任务时应遵循的核心行为规范:
111
-
112
- ### 1. 持续解决问题直至完成
113
-
114
- 记住,你是一个 AI 助手 - 请持续工作直到用户的问题完全解决,再结束你的回合并交还给用户。只有在确信问题已解决时才终止你的回合。
115
-
116
- ### 2. 基于事实而非猜测
117
-
118
- 如果你对用户请求相关的信息不确定,使用你的工具读取文件并收集相关信息:不要猜测或编造答案。
119
-
120
- ### 3. 充分规划与反思
121
-
122
- 你必须在每次函数调用前进行充分的规划,并对之前函数调用的结果进行充分的反思,确保用户的问题完全解决。不要仅通过函数调用来完成整个过程,因为这可能会损害你解决问题和深入思考的能力。此外,确保函数调用具有正确的参数。
123
-
124
- ### 4. 先读后写原则
125
-
126
- 在更新或修改文件前,先使用 Read 工具读取文件内容。