mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-20 14:28:05 +00:00
Initial commit: Synchronize local state with remote
This commit is contained in:
@@ -0,0 +1,97 @@
|
||||
# 🎯 ASCII 图生成任务目标(Task Objective)**
|
||||
|
||||
生成符合严格约束的 **ASCII 架构图/流程图/示意图**。
|
||||
模型在绘图时必须完全遵循下述格式规范,避免使用非 ASCII 字符或任意导致错位的排版。
|
||||
|
||||
## 1. **对齐与结构规则(Alignment Requirements)**
|
||||
|
||||
1. 图中所有字符均需使用 **等宽字符(monospace)** 对齐。
|
||||
2. 所有框体(boxes)必须保证:
|
||||
- 上下左右边界连续无断裂;
|
||||
- 宽度一致(除非任务明确允许可变宽度);
|
||||
- 框体间保持水平对齐或垂直对齐的整体矩形布局。
|
||||
3. 图中所有箭头(`---->`, `<====>`, `<----->` 等)需在水平方向严格对齐,并位于框体之间的**中线位置**。
|
||||
4. 整图不得出现可视上的倾斜、错位、参差不齐等情况。
|
||||
|
||||
## 2. **字符限制(Allowed ASCII Character Set)**
|
||||
|
||||
仅允许使用以下基础 ASCII 字符构图:
|
||||
|
||||
```
|
||||
* * | < > = / \ * . : _ (空格)
|
||||
```
|
||||
|
||||
禁止使用任意 Unicode box-drawing 字符(如:`┌ ─ │ ┘` 等)。
|
||||
|
||||
## 3. **框体规范(Box Construction Rules)**
|
||||
|
||||
框体必须采用标准结构:
|
||||
|
||||
```
|
||||
+---------+
|
||||
| text |
|
||||
+---------+
|
||||
```
|
||||
|
||||
要求如下:
|
||||
|
||||
- 上边和下边:由 `+` 与连续的 `-` 组成;
|
||||
- 左右边:使用 `|`;
|
||||
- 框内文本需保留至少 **1 格空白**间距;
|
||||
- 文本必须保持在框内的合理位置(居中或视觉居中,不破坏结构)。
|
||||
|
||||
## 4. **连接线与箭头(Connections & Arrows)**
|
||||
|
||||
可使用以下箭头样式:
|
||||
|
||||
```
|
||||
<=====> -----> <----->
|
||||
```
|
||||
|
||||
规则如下:
|
||||
|
||||
1. 箭头需紧贴两个框体之间的中心水平线;
|
||||
2. 连接协议名称(如 HTTP、WebSocket、SSH 等)可放置在箭头的上方或下方;
|
||||
3. 协议文本必须对齐同一列,不得错位。
|
||||
|
||||
示例:
|
||||
|
||||
```
|
||||
+-------+ http +-------+
|
||||
| A | <=====> | B |
|
||||
+-------+ websocket +-------+
|
||||
```
|
||||
|
||||
## 5. **文本与注释布局(Text Placement Rules)**
|
||||
|
||||
1. 框内文本必须左右留白,不得触边;
|
||||
2. 框体外的说明文字需与主体结构保持垂直或水平对齐;
|
||||
3. 不允许出现位移使主图结构变形的注解格式。
|
||||
|
||||
## 6. **整体布局规则(Overall Layout Rules)**
|
||||
|
||||
1. 图形布局必须呈现规则矩形结构;
|
||||
2. 多个框体的 **高度、宽度、间距、对齐线** 需保持整齐一致;
|
||||
3. 多行结构必须遵循如下等高原则示例:
|
||||
|
||||
```
|
||||
+--------+ +--------+
|
||||
| A | <---> | B |
|
||||
+--------+ +--------+
|
||||
```
|
||||
|
||||
## ✔️ 参考示例(Expected Output Sample)
|
||||
|
||||
输入任务示例:
|
||||
“绘制 browser → webssh → ssh server 的结构图。”
|
||||
|
||||
模型应按上述规范输出:
|
||||
|
||||
```
|
||||
+---------+ http +---------+ ssh +-------------+
|
||||
| browser | <================> | webssh | <=============> | ssh server |
|
||||
+---------+ websocket +---------+ ssh +-------------+
|
||||
```
|
||||
## 处理内容
|
||||
|
||||
你需要处理的是:
|
||||
@@ -0,0 +1,27 @@
|
||||
# 数据管道
|
||||
|
||||
你的任务是将用户输入的任何内容、请求、指令或目标,转换为一段“工程化代码注释风格的数据处理管道流程”。
|
||||
|
||||
输出要求如下:
|
||||
1. 输出必须为多行、箭头式(->)的工程化流水线描述,类似代码注释
|
||||
2. 每个步骤需使用自然语言精准描述
|
||||
3. 自动从输入中抽取关键信息(任务目标或对象),放入 UserInput(...)
|
||||
4. 若用户输入缺少细节,你需自动补全精准描述
|
||||
5. 输出必须保持以下完全抽象的结构示例:
|
||||
|
||||
UserInput(用户输入内容)
|
||||
-> 占位符1
|
||||
-> 占位符2
|
||||
-> 占位符3
|
||||
-> 占位符4
|
||||
-> 占位符5
|
||||
-> 占位符6
|
||||
-> 占位符7
|
||||
-> 占位符8
|
||||
-> 占位符9
|
||||
|
||||
6. 最终输出只需上述数据管道
|
||||
|
||||
请将用户输入内容转换成以上格式
|
||||
|
||||
你需要处理的是:
|
||||
@@ -0,0 +1,79 @@
|
||||
# 项目变量与工具统一维护
|
||||
|
||||
> **所有维护内容统一追加到项目根目录的:`AGENTS.md` 与 `CLAUDE.md` 文件中。**
|
||||
> 不再在每个目录创建独立文件,全部集中维护。
|
||||
|
||||
## 目标
|
||||
构建一套集中式的 **全局变量索引体系**,统一维护变量信息、变量命名规范、数据来源(上游)、文件调用路径、工具调用路径等内容,确保项目内部的一致性、可追踪性与可扩展性。
|
||||
|
||||
## AGENTS.md 与 CLAUDE.md 的结构规范
|
||||
|
||||
### 1. 变量索引表(核心模块)
|
||||
|
||||
在文件中维护以下标准化、可扩展的表格结构:
|
||||
|
||||
| 变量名(Variable) | 变量说明(Description) | 变量来源(Data Source / Upstream) | 出现位置(File & Line) | 使用频率(Frequency) |
|
||||
|--------------------|-------------------------|-------------------------------------|---------------------------|------------------------|
|
||||
|
||||
#### 字段说明:
|
||||
|
||||
- **变量名(Variable)**:变量的实际名称
|
||||
- **变量说明(Description)**:变量用途、作用、含义
|
||||
- **变量来源(Data Source / Upstream)**:
|
||||
- 上游数据来源
|
||||
- 输入来源文件、API、数据库字段、模块
|
||||
- 无数据来源(手动输入/常量)需明确标注
|
||||
- **出现位置(File & Line)**:标准化格式 `相对路径:行号`
|
||||
- **使用频率(Frequency)**:脚本统计或人工标注
|
||||
|
||||
### 1.1 变量命名与定义规则
|
||||
|
||||
**命名规则:**
|
||||
- 业务类变量需反映业务语义
|
||||
- 数据结构类变量使用 **类型 + 功能** 命名
|
||||
- 新增变量前必须在索引表中检索避免冲突
|
||||
|
||||
**定义规则:**
|
||||
- 所有变量必须附注释(输入、输出、作用范围)
|
||||
- 变量声明尽量靠近使用位置
|
||||
- 全局变量必须在索引表标注为 **Global**
|
||||
|
||||
## 文件与工具调用路径集中维护
|
||||
|
||||
### 2. 文件调用路径对照表
|
||||
|
||||
| 调用来源(From) | 调用目标(To) | 调用方式(Method) | 使用该文件的文件(Used By Files) | 备注 |
|
||||
|------------------|----------------|----------------------|------------------------------------|------|
|
||||
|
||||
**用途:**
|
||||
- 明确文件之间的调用链
|
||||
- 提供依赖可视化能力
|
||||
- 支持 AI 自动维护调用关系
|
||||
|
||||
### 3. 通用工具调用路径对照表
|
||||
(新增:**使用该工具的文件列表(Used By Files)**)
|
||||
|
||||
| 工具来源(From) | 工具目标(To) | 调用方式(Method) | 使用该工具的文件(Used By Files) | 备注 |
|
||||
|------------------|----------------|----------------------|------------------------------------|------|
|
||||
|
||||
**用途:**
|
||||
- 理清工具组件的上下游关系
|
||||
- 构建通用工具的依赖网络
|
||||
- 支持 AI 自动维护和追踪工具使用范围
|
||||
|
||||
## 使用与维护方式
|
||||
|
||||
### 所有信息仅维护于两份文件
|
||||
- 所有新增目录、文件、变量、调用关系、工具调用关系均需 **追加到项目根目录的**:
|
||||
- `AGENTS.md`
|
||||
- `CLAUDE.md`
|
||||
- 两份文件内容必须保持同步。
|
||||
|
||||
## 模型执行稳定性强化要求
|
||||
|
||||
1. 表格列名不可更改
|
||||
2. 表格结构不可删除列、不可破坏格式
|
||||
3. 所有记录均以追加方式维护
|
||||
4. 变量来源必须保持清晰描述,避免模糊术语
|
||||
5. 相对路径必须从项目根目录计算
|
||||
6. 多个上游时允许换行列举
|
||||
Reference in New Issue
Block a user