@pm_zhousl/xinyun-ai-init 1.1.0 → 1.1.1
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.
- package/README.md +2 -0
- package/bin/xinyun-ai-init.js +4 -1
- package/init/xinyun-ai-init/README.md +45 -19
- package/init/xinyun-ai-init/rules/frameworks/README.md +24 -0
- package/init/xinyun-ai-init/rules/frameworks/backend/php/thinkphp.md +26 -0
- package/init/xinyun-ai-init/rules/frameworks/frontend/uni-app.md +28 -0
- package/init/xinyun-ai-init/rules/frameworks/frontend/wechat-miniprogram.md +28 -0
- package/init/xinyun-ai-init/rules/init-rules.md +2 -1
- package/init/xinyun-ai-init/rules/upgrade-rules.md +4 -3
- package/init/xinyun-ai-init/templates/AGENTS.template.md +6 -0
- package/init/xinyun-ai-init/templates/README.template.md +2 -2
- package/init/xinyun-ai-init/templates/core-rules.template.md +31 -34
- package/init/xinyun-ai-init/templates/current-task.template.md +1 -3
- package/init/xinyun-ai-init/templates/manifest.template.json +6 -7
- package/init/xinyun-ai-init/templates/project-check.template.md +1 -1
- package/init/xinyun-ai-init/templates/project-guide.template.md +8 -0
- package/init/xinyun-ai-init/templates/project-index.template.json +1 -3
- package/init/xinyun-ai-init/version.json +2 -2
- package/package.json +1 -1
- package/init/xinyun-ai-init/rules/requirement-ui-understanding.md +0 -35
- package/init/xinyun-ai-init/rules/requirements-rules.md +0 -43
- package/init/xinyun-ai-init/templates/requirement.template.md +0 -33
package/README.md
CHANGED
package/bin/xinyun-ai-init.js
CHANGED
|
@@ -122,6 +122,7 @@ async function main() {
|
|
|
122
122
|
|
|
123
123
|
if (!fs.existsSync(source)) {
|
|
124
124
|
console.error("[xinyun-ai-init] Init package missing:", source);
|
|
125
|
+
console.error("[xinyun-ai-init] Please reinstall or run with @latest.");
|
|
125
126
|
process.exit(1);
|
|
126
127
|
}
|
|
127
128
|
|
|
@@ -137,7 +138,8 @@ async function main() {
|
|
|
137
138
|
}
|
|
138
139
|
|
|
139
140
|
copyDir(source, target);
|
|
140
|
-
console.log("[xinyun-ai-init] Created:", target);
|
|
141
|
+
console.log("[xinyun-ai-init] Created init package:", target);
|
|
142
|
+
console.log("[xinyun-ai-init] This CLI only creates xinyun-ai-init/. It does not create xinyun-ai/ or modify business code.");
|
|
141
143
|
console.log("");
|
|
142
144
|
printNextStep();
|
|
143
145
|
}
|
|
@@ -148,6 +150,7 @@ function printNextStep() {
|
|
|
148
150
|
console.log("请执行 `npx --yes @pm_zhousl/xinyun-ai-init@latest --force`,然后读取 `xinyun-ai-init/README.md`,按其中规则初始化或升级当前项目。");
|
|
149
151
|
console.log("");
|
|
150
152
|
console.log("The full workflow is in xinyun-ai-init/README.md. No long prompt is needed.");
|
|
153
|
+
console.log("After this message, the AI may create or update the minimal xinyun-ai/ workspace, but must not modify business code without confirmation.");
|
|
151
154
|
console.log("");
|
|
152
155
|
}
|
|
153
156
|
|
|
@@ -24,13 +24,21 @@ AI 读取本文件后,必须按以下方式执行:
|
|
|
24
24
|
|
|
25
25
|
1. 如果当前项目没有 `xinyun-ai/`,进入极速初始化模式。
|
|
26
26
|
2. 如果当前项目已有 `xinyun-ai/`,进入升级检查模式。
|
|
27
|
-
3.
|
|
27
|
+
3. 用户发送 Codex 一句话入口后,视为已授权 AI 按本初始化包创建或补齐最小 `xinyun-ai/` 与极简 `AGENTS.md`。
|
|
28
28
|
4. 代码整改前必须先输出修改方案,等待用户明确确认后才能执行。
|
|
29
29
|
5. 涉及 SQL / 数据库改动时,必须单独输出 SQL 执行提醒。
|
|
30
30
|
6. 非项目开发内容不要沉淀。
|
|
31
31
|
7. 首次初始化不执行语言级语法检查、lint、typecheck、测试或构建命令;本机缺少运行时只记录为待确认,不展开长解释。
|
|
32
32
|
8. 完成后用中文输出初始化或升级结果、项目导读、待确认问题和后续短指令。
|
|
33
33
|
|
|
34
|
+
## 初始化授权边界
|
|
35
|
+
|
|
36
|
+
CLI 只负责生成 `xinyun-ai-init/`,不创建 `xinyun-ai/`,也不修改业务代码。
|
|
37
|
+
|
|
38
|
+
用户发送一句话入口后,AI 可以按本 README 和 `templates/` 创建或补齐首次最小落盘清单。
|
|
39
|
+
|
|
40
|
+
该授权只覆盖 AI 工作区初始化,不代表授权修改业务代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程。
|
|
41
|
+
|
|
34
42
|
## 代码修改强制确认
|
|
35
43
|
|
|
36
44
|
用户提出“帮我改”“修复”“处理一下”“优化一下”只代表提出需求,不代表授权执行。
|
|
@@ -49,6 +57,16 @@ AI 读取本文件后,必须按以下方式执行:
|
|
|
49
57
|
|
|
50
58
|
只有用户明确回复“确认执行”“可以修改”“按方案改”“同意”等类似内容后,才允许在确认范围内执行。
|
|
51
59
|
|
|
60
|
+
## 统一入口与旧规则失效
|
|
61
|
+
|
|
62
|
+
当前项目 AI 规则以 `xinyun-ai/` 为准,`AGENTS.md` 只作为入口文件,指向 `xinyun-ai/`。
|
|
63
|
+
|
|
64
|
+
旧 AI 文档、旧 docs、旧提示词、旧规则文件只作为历史线索,不作为执行依据。
|
|
65
|
+
|
|
66
|
+
如果旧规则路径在当前文件系统中不存在,必须标注为 `当前项目未发现`,不得引用历史会话中的旧内容。
|
|
67
|
+
|
|
68
|
+
如旧规则与 `xinyun-ai/` 冲突,以 `xinyun-ai/` 为准。
|
|
69
|
+
|
|
52
70
|
## 欣芸技术开发 Agent 流
|
|
53
71
|
|
|
54
72
|
这是一套面向 AI 编程工具的本地项目接手、按需理解、受控开发和持续沉淀方法论。
|
|
@@ -62,21 +80,19 @@ AI 读取本文件后,必须按以下方式执行:
|
|
|
62
80
|
5. 受控整改:只在确认范围内修改,不顺手重构。
|
|
63
81
|
6. 技术沉淀:会话结束前筛选有价值内容,沉淀到 `xinyun-ai/`;经验先候选,确认后升级。
|
|
64
82
|
|
|
65
|
-
##
|
|
66
|
-
|
|
67
|
-
涉及功能开发、业务流程、API、数据库、页面、组件、交互或样式时,AI 在输出修改方案前,必须先完成轻量需求理解。
|
|
68
|
-
|
|
69
|
-
如果当前 AI 工具有需求分析、原型、UI 交互、截图风格识别等 Skill,优先调用对应 Skill;如果没有,则按 `rules/requirement-ui-understanding.md` 的清单兜底。
|
|
70
|
-
|
|
71
|
-
信息不足时,只问 1-3 个关键问题,不展开长问卷。
|
|
83
|
+
## 轻量框架适配
|
|
72
84
|
|
|
73
|
-
|
|
85
|
+
首期只提供 ThinkPHP、uni-app、微信小程序的轻量识别规则,位置:
|
|
74
86
|
|
|
75
|
-
|
|
87
|
+
```md
|
|
88
|
+
rules/frameworks/backend/php/thinkphp.md
|
|
89
|
+
rules/frameworks/frontend/uni-app.md
|
|
90
|
+
rules/frameworks/frontend/wechat-miniprogram.md
|
|
91
|
+
```
|
|
76
92
|
|
|
77
|
-
|
|
93
|
+
框架适配只帮助 AI 定位入口、配置、页面 / 路由、请求封装线索,不做深度扫描,不默认创建大量框架说明文件。
|
|
78
94
|
|
|
79
|
-
|
|
95
|
+
未识别到对应框架时,不强行套用该框架规则。
|
|
80
96
|
|
|
81
97
|
## 执行模式
|
|
82
98
|
|
|
@@ -132,6 +148,15 @@ xinyun-ai/index/project-index.json
|
|
|
132
148
|
- 不读取大目录和生成物:`node_modules`、`vendor`、`dist`、`build`、`.git`、`.codegraph`、`storage`、`runtime`、`unpackage`、`coverage`、`.next`、`.nuxt`。
|
|
133
149
|
- 不确定的信息标注:`推断`、`待确认`、`未在项目中发现`。
|
|
134
150
|
|
|
151
|
+
## 检索与回复规则
|
|
152
|
+
|
|
153
|
+
- 先读 `AGENTS.md`、`xinyun-ai/manifest.json`、`xinyun-ai/index/project-index.json`、`xinyun-ai/current-task.md`。
|
|
154
|
+
- 有 CodeGraph 时,结构性问题优先使用 CodeGraph。
|
|
155
|
+
- 先判断影响端,再读取对应 `workstreams/<端>/` 和相关文件。
|
|
156
|
+
- 输出中区分 `已确认`、`推断`、`待确认`、`未在项目中发现`。
|
|
157
|
+
- 回复先给结论,再给依据路径,再给待确认问题。
|
|
158
|
+
- 不沿用用户已经纠正或否定的旧方向。
|
|
159
|
+
|
|
135
160
|
## 按需补齐
|
|
136
161
|
|
|
137
162
|
后续识别到新端、模块或能力时,只在 `xinyun-ai/` 内补齐对应目录和说明文件。
|
|
@@ -192,10 +217,11 @@ npx --yes @pm_zhousl/xinyun-ai-init@latest --force
|
|
|
192
217
|
初始化或升级完成后,输出:
|
|
193
218
|
|
|
194
219
|
1. 当前执行模式:初始化 / 升级检查 / 部分完成 / 阻塞。
|
|
195
|
-
2.
|
|
196
|
-
3.
|
|
197
|
-
4.
|
|
198
|
-
5.
|
|
199
|
-
6.
|
|
200
|
-
7.
|
|
201
|
-
8.
|
|
220
|
+
2. 当前版本、目标版本、是否影响业务代码。
|
|
221
|
+
3. 已创建或已更新的 `xinyun-ai/` 文件。
|
|
222
|
+
4. 项目一句话概览。
|
|
223
|
+
5. 识别到的端、模块、技术栈、本地启动线索。
|
|
224
|
+
6. 数据库、API、测试体系发现情况。
|
|
225
|
+
7. CodeGraph 与索引状态。
|
|
226
|
+
8. 待确认问题。
|
|
227
|
+
9. 后续日常开发和问题排查短指令。
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# 框架适配规则
|
|
2
|
+
|
|
3
|
+
本目录用于按端和框架存放轻量识别规则。
|
|
4
|
+
|
|
5
|
+
## 目录约定
|
|
6
|
+
|
|
7
|
+
```md
|
|
8
|
+
frameworks/backend/<language>/<framework>.md
|
|
9
|
+
frameworks/frontend/<framework>.md
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
首期只集成:
|
|
13
|
+
|
|
14
|
+
- `backend/php/thinkphp.md`
|
|
15
|
+
- `frontend/uni-app.md`
|
|
16
|
+
- `frontend/wechat-miniprogram.md`
|
|
17
|
+
|
|
18
|
+
## 执行边界
|
|
19
|
+
|
|
20
|
+
- 框架适配只用于帮助 AI 定位入口、配置、页面 / 路由、请求封装线索。
|
|
21
|
+
- 不做深度扫描。
|
|
22
|
+
- 不默认创建大量框架说明文件。
|
|
23
|
+
- 未识别到对应框架时,不强行套用该框架规则。
|
|
24
|
+
- 多端项目应分别说明每个端口的框架、入口、启动线索和请求链路线索。
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# ThinkPHP 轻量识别规则
|
|
2
|
+
|
|
3
|
+
## 识别线索
|
|
4
|
+
|
|
5
|
+
- `composer.json` 中存在 `topthink/framework`
|
|
6
|
+
- 存在 `public/index.php` 或 `think`
|
|
7
|
+
- 存在 `app/`、`config/`、`route/`
|
|
8
|
+
- 存在 `app/*/controller`、`app/*/model`、`app/*/service`
|
|
9
|
+
- 代码中出现 `think\facade`、`think\Request`、`think\Response`
|
|
10
|
+
|
|
11
|
+
## 接手重点
|
|
12
|
+
|
|
13
|
+
1. 应用入口:`public/index.php`、`think`
|
|
14
|
+
2. 路由位置:`route/`、`config/route.php`、注解路由线索
|
|
15
|
+
3. 模块结构:`app/<module>/controller`、`model`、`service`、`validate`、`middleware`
|
|
16
|
+
4. 配置位置:`config/`、`.env`
|
|
17
|
+
5. 公共前置逻辑:`middleware`、控制器基类、公共调用位置
|
|
18
|
+
6. 命令任务:`app/command`、`config/console.php`
|
|
19
|
+
7. 异常处理:`app/ExceptionHandle.php` 或项目自定义异常处理
|
|
20
|
+
8. 返回结构:控制器统一响应方法、JSON 返回规范
|
|
21
|
+
|
|
22
|
+
## 边界
|
|
23
|
+
|
|
24
|
+
- 只做轻量识别,不追完整调用链。
|
|
25
|
+
- 不把 ThinkPHP 规则套到其他 PHP 框架。
|
|
26
|
+
- 不默认生成大量 ThinkPHP 说明文件。
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# uni-app 轻量识别规则
|
|
2
|
+
|
|
3
|
+
## 识别线索
|
|
4
|
+
|
|
5
|
+
- `pages.json`
|
|
6
|
+
- `manifest.json`
|
|
7
|
+
- `App.vue`
|
|
8
|
+
- `main.js` / `main.ts`
|
|
9
|
+
- `pages/`、`components/`、`static/`
|
|
10
|
+
- `package.json` 中出现 `@dcloudio`、`uni-app`、`vite-plugin-uni`
|
|
11
|
+
|
|
12
|
+
## 接手重点
|
|
13
|
+
|
|
14
|
+
1. 应用入口:`main.js` / `main.ts`、`App.vue`
|
|
15
|
+
2. 页面配置:`pages.json`
|
|
16
|
+
3. 平台配置:`manifest.json`
|
|
17
|
+
4. 页面目录:`pages/`
|
|
18
|
+
5. 分包配置:`subPackages`
|
|
19
|
+
6. 组件目录:`components/`
|
|
20
|
+
7. 静态资源:`static/`
|
|
21
|
+
8. 请求封装:常见 `utils/request`、`common/request`、`api/`
|
|
22
|
+
9. 登录态与缓存:`uni.getStorageSync`、`uni.setStorageSync`
|
|
23
|
+
10. 条件编译:`#ifdef`、`#ifndef`
|
|
24
|
+
|
|
25
|
+
## 边界
|
|
26
|
+
|
|
27
|
+
- 只做轻量识别,不默认创建大量框架说明文件。
|
|
28
|
+
- 不把 uni-app 规则套到原生微信小程序。
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# 微信小程序轻量识别规则
|
|
2
|
+
|
|
3
|
+
## 识别线索
|
|
4
|
+
|
|
5
|
+
- `app.json`
|
|
6
|
+
- `app.js` / `app.ts`
|
|
7
|
+
- `app.wxss`
|
|
8
|
+
- 页面包含 `.wxml`、`.wxss`、`.js` / `.ts`、`.json`
|
|
9
|
+
- `project.config.json`
|
|
10
|
+
- `sitemap.json`
|
|
11
|
+
|
|
12
|
+
## 接手重点
|
|
13
|
+
|
|
14
|
+
1. 应用入口:`app.js` / `app.ts`
|
|
15
|
+
2. 全局配置:`app.json`
|
|
16
|
+
3. 页面路径:`pages`
|
|
17
|
+
4. 分包配置:`subpackages` / `subPackages`
|
|
18
|
+
5. 页面结构:`.wxml`
|
|
19
|
+
6. 页面样式:`.wxss`
|
|
20
|
+
7. 页面逻辑:`.js` / `.ts`
|
|
21
|
+
8. 组件:`components/`
|
|
22
|
+
9. 请求封装:`wx.request` 或项目封装
|
|
23
|
+
10. 登录流程:`wx.login`、用户信息获取、token 缓存
|
|
24
|
+
|
|
25
|
+
## 边界
|
|
26
|
+
|
|
27
|
+
- 只做轻量识别,不默认创建大量框架说明文件。
|
|
28
|
+
- 不把微信小程序规则套到 uni-app。
|
|
@@ -6,4 +6,5 @@
|
|
|
6
6
|
- 每个端最多读取 3-5 个关键文件。
|
|
7
7
|
- 不确定的信息标注:`推断`、`待确认`、`未在项目中发现`。
|
|
8
8
|
- 首次初始化必须把“代码修改强制确认规则”写入 `AGENTS.md` 和 `xinyun-ai/rules/core-rules.md`。
|
|
9
|
-
-
|
|
9
|
+
- 用户发送一句话入口后,视为已授权创建或补齐最小 `xinyun-ai/` 与极简 `AGENTS.md`。
|
|
10
|
+
- 初始化授权不包含业务代码、配置、数据库、API、UI 或业务流程修改。
|
|
@@ -16,8 +16,9 @@
|
|
|
16
16
|
|
|
17
17
|
- `AGENTS.md` 是否包含代码修改强制确认规则。
|
|
18
18
|
- `xinyun-ai/rules/core-rules.md` 是否包含代码修改强制确认规则。
|
|
19
|
-
-
|
|
20
|
-
-
|
|
19
|
+
- `AGENTS.md` 是否明确 `xinyun-ai/` 为当前项目 AI 规则入口。
|
|
20
|
+
- 旧 AI 规则路径不存在时,是否标注为 `当前项目未发现`,并停止引用旧会话内容。
|
|
21
|
+
- 是否需要补充轻量框架适配识别规则。
|
|
21
22
|
- 当前 `xinyun-ai/manifest.json` 的版本是否低于初始化包版本。
|
|
22
23
|
|
|
23
|
-
|
|
24
|
+
涉及正式规则、目录结构、索引结构或旧规则合并时,必须先确认。
|
|
@@ -2,6 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
本项目使用 `xinyun-ai/` 管理 AI 协作规则。
|
|
4
4
|
|
|
5
|
+
当前项目 AI 规则以 `xinyun-ai/` 为准。旧 AI 文档、旧 docs、旧提示词、旧规则文件只作为历史线索,不作为执行依据。
|
|
6
|
+
|
|
7
|
+
如果旧规则路径在当前文件系统中不存在,必须标注为 `当前项目未发现`,不得引用历史会话中的旧内容。如旧规则与 `xinyun-ai/` 冲突,以 `xinyun-ai/` 为准。
|
|
8
|
+
|
|
5
9
|
## 代码修改强制确认规则
|
|
6
10
|
|
|
7
11
|
任何代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程修改前,AI 必须先输出修改方案,并等待用户明确确认。
|
|
@@ -12,6 +16,8 @@
|
|
|
12
16
|
|
|
13
17
|
只有用户明确回复“确认执行”“可以修改”“按方案改”“同意”等类似内容后,才允许在确认范围内执行。
|
|
14
18
|
|
|
19
|
+
说明:用户发送 `xinyun-ai-init` 一句话入口后,视为已授权 AI 创建或补齐最小 `xinyun-ai/` 与本入口文件;该授权不包含业务代码、配置、数据库、API、UI 或业务流程修改。
|
|
20
|
+
|
|
15
21
|
AI 接手本项目时,请先读取:
|
|
16
22
|
|
|
17
23
|
- `xinyun-ai/README.md`
|
|
@@ -8,8 +8,8 @@
|
|
|
8
8
|
- 后续 AI 会话优先读取 `manifest.json`、`current-task.md`、`rules/core-rules.md`、`index/project-index.json`。
|
|
9
9
|
- 业务代码、配置、数据库、API、UI、业务流程修改前必须先出计划并等待确认。
|
|
10
10
|
- 用户提出“帮我改”“修复”“处理一下”“优化一下”只代表提出需求,不代表授权执行。
|
|
11
|
-
-
|
|
12
|
-
-
|
|
11
|
+
- 当前项目 AI 规则以 `xinyun-ai/` 为准,旧 AI 规则只作为历史线索。
|
|
12
|
+
- 检索时先按端和当前任务收敛范围,不做无关全量扫描。
|
|
13
13
|
- 后续识别到新端、模块或能力时,只在 `xinyun-ai/` 内按需补齐对应目录和说明文件。
|
|
14
14
|
|
|
15
15
|
## 核心流程
|
|
@@ -1,23 +1,26 @@
|
|
|
1
|
-
|
|
1
|
+
# xinyun-ai 核心规则
|
|
2
2
|
|
|
3
|
-
##
|
|
3
|
+
## 统一入口
|
|
4
4
|
|
|
5
|
-
-
|
|
6
|
-
-
|
|
5
|
+
- 当前项目 AI 规则以 `xinyun-ai/` 为准。
|
|
6
|
+
- `AGENTS.md` 只作为入口文件,指向 `xinyun-ai/`。
|
|
7
|
+
- 旧 AI 文档、旧 docs、旧提示词、旧规则文件只作为历史线索,不作为执行依据。
|
|
8
|
+
- 如果旧规则路径在当前文件系统中不存在,必须标注为 `当前项目未发现`,不得引用历史会话中的旧内容。
|
|
9
|
+
- 如旧规则与 `xinyun-ai/` 冲突,以 `xinyun-ai/` 为准。
|
|
10
|
+
|
|
11
|
+
## 初始化授权边界
|
|
12
|
+
|
|
13
|
+
- 用户发送 `xinyun-ai-init` 一句话入口后,视为已授权 AI 创建或补齐最小 `xinyun-ai/` 与极简 `AGENTS.md`。
|
|
14
|
+
- 该授权不包含业务代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程修改。
|
|
15
|
+
|
|
16
|
+
## 代码修改确认
|
|
17
|
+
|
|
18
|
+
- 代码整改前必须先给修改方案,待用户明确确认后才能执行。
|
|
7
19
|
- 用户提出“帮我改”“修复”“处理一下”“优化一下”只代表提出需求,不代表授权执行。
|
|
8
20
|
- 未确认前,只允许读取、分析、定位问题、输出方案;禁止 `apply_patch`、重写文件、格式化、自动修复、migration、seed、SQL、配置修改和任何会产生文件变化或业务副作用的命令。
|
|
9
|
-
-
|
|
10
|
-
- 非项目内容不沉淀。
|
|
11
|
-
- 多端项目按 `workstreams/<端名称>/` 分开说明。
|
|
12
|
-
- 旧 AI 记录只审计,不默认相信、不覆盖。
|
|
13
|
-
- CodeGraph 不可擅自初始化。
|
|
14
|
-
- 敏感信息不泄露。
|
|
15
|
-
- 自我学习只沉淀候选经验,不自动改正式规则。
|
|
16
|
-
- 目录自完善只补 `xinyun-ai/` 文档和索引,不修改业务代码。
|
|
17
|
-
|
|
18
|
-
## 修改方案要求
|
|
21
|
+
- 确认后只改确认范围内的文件,不顺手重构、不顺手格式化无关文件。
|
|
19
22
|
|
|
20
|
-
|
|
23
|
+
修改方案至少包含:
|
|
21
24
|
|
|
22
25
|
1. 修改目标
|
|
23
26
|
2. 影响范围
|
|
@@ -27,27 +30,21 @@
|
|
|
27
30
|
6. 验证方式
|
|
28
31
|
7. 风险点
|
|
29
32
|
|
|
30
|
-
##
|
|
31
|
-
|
|
32
|
-
涉及功能、业务流程、API、数据库、页面、组件、交互或样式时,输出修改方案前必须先完成简版需求理解。
|
|
33
|
-
|
|
34
|
-
如果当前 AI 工具有需求分析、原型、UI 交互、截图风格识别等 Skill,优先使用对应 Skill;没有 Skill 时,按内置清单兜底,不阻塞任务。
|
|
35
|
-
|
|
36
|
-
需求理解至少确认:用户要解决的问题、预期结果、涉及端、涉及数据、验收标准和不明确点。
|
|
37
|
-
|
|
38
|
-
UI 理解至少确认:页面位置、现有风格、用户操作路径、默认 / 加载 / 空数据 / 错误 / 成功状态、多端适配影响和是否需要参考截图。
|
|
39
|
-
|
|
40
|
-
信息不足时,最多提出 1-3 个关键问题,不展开长问卷。
|
|
41
|
-
|
|
42
|
-
## 需求沉淀
|
|
43
|
-
|
|
44
|
-
确认是开发需求时,可按需创建 `xinyun-ai/requirements/` 并使用 `REQ-YYYYMMDD-001` 格式编号。
|
|
33
|
+
## 检索与回复
|
|
45
34
|
|
|
46
|
-
|
|
35
|
+
- 先读 `AGENTS.md`、`xinyun-ai/manifest.json`、`xinyun-ai/index/project-index.json`、`xinyun-ai/current-task.md`。
|
|
36
|
+
- 有 CodeGraph 时,结构性问题优先使用 CodeGraph。
|
|
37
|
+
- 先判断影响端,再读取对应 `workstreams/<端>/` 和相关文件。
|
|
38
|
+
- 输出中区分 `已确认`、`推断`、`待确认`、`未在项目中发现`。
|
|
39
|
+
- 回复先给结论,再给依据路径,再给待确认问题。
|
|
40
|
+
- 不沿用用户已经纠正或否定的旧方向。
|
|
47
41
|
|
|
48
|
-
|
|
42
|
+
## 框架适配
|
|
49
43
|
|
|
50
|
-
|
|
44
|
+
- 框架适配规则位于 `xinyun-ai-init/rules/frameworks/`。
|
|
45
|
+
- 首期只支持 ThinkPHP、uni-app、微信小程序的轻量识别。
|
|
46
|
+
- 框架适配只帮助定位入口、配置、页面 / 路由、请求封装线索,不做深度扫描。
|
|
47
|
+
- 未识别到对应框架时,不强行套用该框架规则。
|
|
51
48
|
|
|
52
49
|
## 理解深度状态
|
|
53
50
|
|
|
@@ -63,4 +60,4 @@ UI 理解至少确认:页面位置、现有风格、用户操作路径、默
|
|
|
63
60
|
|
|
64
61
|
## 自我学习
|
|
65
62
|
|
|
66
|
-
发现可复用经验时,先记录为候选经验。候选经验必须标注来源、适用范围、可信度、状态和最后验证时间。用户确认后,才能合并进正式规则。
|
|
63
|
+
发现可复用经验时,先记录为候选经验。候选经验必须标注来源、适用范围、可信度、状态和最后验证时间。用户确认后,才能合并进正式规则。
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"projectName": "",
|
|
3
|
-
"xinyunAiVersion": "1.1.
|
|
4
|
-
"scriptVersion": "2026.07.
|
|
3
|
+
"xinyunAiVersion": "1.1.1",
|
|
4
|
+
"scriptVersion": "2026.07.14",
|
|
5
5
|
"schemaVersion": "1",
|
|
6
6
|
"initializationMode": "fast",
|
|
7
7
|
"expansionMode": "triggered",
|
|
@@ -10,15 +10,14 @@
|
|
|
10
10
|
"overall": "quick",
|
|
11
11
|
"workstreams": {},
|
|
12
12
|
"database": "unknown",
|
|
13
|
-
"api": "unknown"
|
|
14
|
-
"requirements": "unknown"
|
|
13
|
+
"api": "unknown"
|
|
15
14
|
},
|
|
16
15
|
"codegraph": { "enabled": false, "status": "unknown" },
|
|
17
16
|
"index": { "primary": "json_markdown", "sqlite": "optional" },
|
|
18
17
|
"capabilities": {
|
|
19
18
|
"confirmationGate": true,
|
|
20
|
-
"
|
|
21
|
-
"
|
|
22
|
-
"
|
|
19
|
+
"legacyRuleHandoff": true,
|
|
20
|
+
"lightFrameworkDetection": true,
|
|
21
|
+
"focusedSearchResponse": true
|
|
23
22
|
}
|
|
24
23
|
}
|
|
@@ -4,12 +4,10 @@
|
|
|
4
4
|
"overall": "quick",
|
|
5
5
|
"workstreams": {},
|
|
6
6
|
"database": "unknown",
|
|
7
|
-
"api": "unknown"
|
|
8
|
-
"requirements": "unknown"
|
|
7
|
+
"api": "unknown"
|
|
9
8
|
},
|
|
10
9
|
"database": "unknown",
|
|
11
10
|
"api": "unknown",
|
|
12
|
-
"requirements": "unknown",
|
|
13
11
|
"tests": "unknown",
|
|
14
12
|
"lastUpdatedAt": ""
|
|
15
13
|
}
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"packageName": "xinyun-ai-init",
|
|
3
3
|
"displayName": "欣芸技术开发 Agent 流初始化包",
|
|
4
|
-
"version": "1.1.
|
|
5
|
-
"scriptVersion": "2026.07.
|
|
4
|
+
"version": "1.1.1",
|
|
5
|
+
"scriptVersion": "2026.07.14",
|
|
6
6
|
"schemaVersion": "1",
|
|
7
7
|
"defaultMode": "fast-init",
|
|
8
8
|
"targetWorkspace": "xinyun-ai",
|
package/package.json
CHANGED
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
# 需求与 UI 理解规则
|
|
2
|
-
|
|
3
|
-
开发类任务在输出修改方案前,必须先判断是否需要需求理解或 UI 理解。
|
|
4
|
-
|
|
5
|
-
## Skill 适配
|
|
6
|
-
|
|
7
|
-
如果当前 AI 工具有以下类型 Skill,应优先使用:
|
|
8
|
-
|
|
9
|
-
- 需求理解类:`requirements-analyst`、PRD analyst、product requirements、user story、acceptance criteria
|
|
10
|
-
- 原型流程类:`prototype-designer`、product flow、screen map、information architecture
|
|
11
|
-
- UI 交互类:`ui-interaction-designer`、UI/UX designer、design reviewer
|
|
12
|
-
- 截图风格类:`ui-screenshot-style-coder`、screenshot style、视觉还原
|
|
13
|
-
- 全流程编排类:`product-build-orchestrator`、PRD to task、PRD to RFC
|
|
14
|
-
|
|
15
|
-
如果没有对应 Skill,使用本规则内置清单兜底,不阻塞任务。
|
|
16
|
-
|
|
17
|
-
## 需求理解清单
|
|
18
|
-
|
|
19
|
-
1. 用户要解决的问题
|
|
20
|
-
2. 预期结果
|
|
21
|
-
3. 涉及端:server / admin / app / pc / 其他
|
|
22
|
-
4. 涉及数据:数据库 / API / 配置 / 文件
|
|
23
|
-
5. 验收标准
|
|
24
|
-
6. 不明确点
|
|
25
|
-
|
|
26
|
-
## UI 理解清单
|
|
27
|
-
|
|
28
|
-
1. 页面位置
|
|
29
|
-
2. 现有 UI 风格
|
|
30
|
-
3. 用户操作路径
|
|
31
|
-
4. 页面状态:默认 / 加载 / 空数据 / 错误 / 成功
|
|
32
|
-
5. 是否影响移动端、多端适配或权限状态
|
|
33
|
-
6. 是否需要参考截图、原型或现有页面
|
|
34
|
-
|
|
35
|
-
信息不足时,只问 1-3 个关键问题。
|
|
@@ -1,43 +0,0 @@
|
|
|
1
|
-
# 需求沉淀与任务追踪规则
|
|
2
|
-
|
|
3
|
-
需求沉淀只服务于项目开发,不记录普通聊天、工具咨询、与当前项目无关的内容。
|
|
4
|
-
|
|
5
|
-
## 触发场景
|
|
6
|
-
|
|
7
|
-
- 新功能开发
|
|
8
|
-
- 业务规则调整
|
|
9
|
-
- 页面 / 交互 / 样式修改
|
|
10
|
-
- API 行为变化
|
|
11
|
-
- 数据库 / SQL 改动
|
|
12
|
-
- 问题修复中产生可复用需求结论
|
|
13
|
-
|
|
14
|
-
## 不沉淀场景
|
|
15
|
-
|
|
16
|
-
- 普通聊天
|
|
17
|
-
- 工具使用咨询
|
|
18
|
-
- 临时排查但无长期项目价值
|
|
19
|
-
- 用户明确说“不需要记录”
|
|
20
|
-
- 与当前项目无关的内容
|
|
21
|
-
|
|
22
|
-
## 编号与状态
|
|
23
|
-
|
|
24
|
-
需求编号格式:
|
|
25
|
-
|
|
26
|
-
```md
|
|
27
|
-
REQ-YYYYMMDD-001
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
需求状态:
|
|
31
|
-
|
|
32
|
-
- `draft`:草稿 / 待确认
|
|
33
|
-
- `confirmed`:已确认
|
|
34
|
-
- `planned`:已有方案
|
|
35
|
-
- `in_progress`:执行中
|
|
36
|
-
- `done`:已完成
|
|
37
|
-
- `cancelled`:已取消
|
|
38
|
-
|
|
39
|
-
## 记录要求
|
|
40
|
-
|
|
41
|
-
需求记录至少包含:原始需求、需求理解、涉及端、数据库 / API / UI / 配置影响、待确认问题、方案摘要、验收标准、实际改动文件、SQL 执行提醒、验证结果和最后更新时间。
|
|
42
|
-
|
|
43
|
-
运行到具体项目时,按需创建 `xinyun-ai/requirements/`,首次初始化不主动创建大量需求目录。
|
|
@@ -1,33 +0,0 @@
|
|
|
1
|
-
# 需求记录
|
|
2
|
-
|
|
3
|
-
- 需求编号:REQ-YYYYMMDD-001
|
|
4
|
-
- 状态:draft
|
|
5
|
-
- 创建时间:
|
|
6
|
-
- 最后更新时间:
|
|
7
|
-
|
|
8
|
-
## 用户原始需求
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
## 需求理解
|
|
12
|
-
|
|
13
|
-
- 要解决的问题:
|
|
14
|
-
- 预期结果:
|
|
15
|
-
- 涉及端:
|
|
16
|
-
- 涉及数据库 / API / UI / 配置:
|
|
17
|
-
- 不明确点:
|
|
18
|
-
|
|
19
|
-
## 验收标准
|
|
20
|
-
|
|
21
|
-
1.
|
|
22
|
-
|
|
23
|
-
## 修改方案摘要
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
## 实际改动
|
|
27
|
-
|
|
28
|
-
- 改动文件:
|
|
29
|
-
- SQL 执行提醒:
|
|
30
|
-
- 验证结果:
|
|
31
|
-
|
|
32
|
-
## 备注
|
|
33
|
-
|