@pm_zhousl/xinyun-ai-init 1.0.0

package/README.md

@@ -0,0 +1,27 @@
+# @pm_zhousl/xinyun-ai-init
+
+欣芸技术开发 Agent 流初始化包。
+
+## 使用方式
+
+在目标代码项目根目录执行：
+
+```bash
+npx @pm_zhousl/xinyun-ai-init
+```
+
+执行后会在当前目录生成：
+
+```md
+xinyun-ai-init/
+```
+
+然后把下面这句话发给 Codex / Cursor / Claude Code：
+
+```md
+请读取当前项目根目录下的 `xinyun-ai-init/README.md`，按“欣芸技术开发 Agent 流”初始化或升级当前项目；未获确认前不要修改业务代码。
+```
+
+## 注意
+
+该 CLI 只释放初始化包，不修改业务代码。

package/bin/xinyun-ai-init.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+
+const args = new Set(process.argv.slice(2));
+const force = args.has("--force") || args.has("-f");
+const cwd = process.cwd();
+const source = path.resolve(__dirname, "..", "init", "xinyun-ai-init");
+const target = path.join(cwd, "xinyun-ai-init");
+
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function main() {
+  if (!fs.existsSync(source)) {
+    console.error("[xinyun-ai-init] 初始化包缺失：", source);
+    process.exit(1);
+  }
+
+  if (fs.existsSync(target)) {
+    if (!force) {
+      console.log("[xinyun-ai-init] 当前目录已存在 xinyun-ai-init/，未覆盖。");
+      console.log("[xinyun-ai-init] 如需覆盖，请执行：npx @pm_zhousl/xinyun-ai-init --force");
+      console.log("");
+      printNextStep();
+      return;
+    }
+    fs.rmSync(target, { recursive: true, force: true });
+  }
+
+  copyDir(source, target);
+  console.log("[xinyun-ai-init] 已生成：", target);
+  console.log("");
+  printNextStep();
+}
+
+function printNextStep() {
+  console.log("下一步：把下面这句话发给 Codex / Cursor / Claude Code：");
+  console.log("");
+  console.log("请读取当前项目根目录下的 `xinyun-ai-init/README.md`，按“欣芸技术开发 Agent 流”初始化或升级当前项目；未获确认前不要修改业务代码。");
+  console.log("");
+}
+
+main();

package/init/xinyun-ai-init/README.md

@@ -0,0 +1,137 @@
+# xinyun-ai-init 初始化包
+
+本目录是“欣芸技术开发 Agent 流”的初始化包。
+
+使用方式：
+
+1. 将 `xinyun-ai-init.zip` 放到目标代码项目根目录。
+2. 解压后得到 `xinyun-ai-init/`。
+3. 打开 Codex、Cursor、Claude Code 或其他 AI 编程工具，并确保当前工作目录是目标项目根目录。
+4. 输入：
+
+```md
+请读取当前项目根目录下的 `xinyun-ai-init/README.md`，按“欣芸技术开发 Agent 流”初始化或升级当前项目；未获确认前不要修改业务代码。
+```
+
+## 欣芸技术开发 Agent 流
+
+这是一套面向 AI 编程工具的本地项目接手、按需理解、受控开发和持续沉淀方法论。
+
+流程：
+
+1. 极速初始化：首次只创建最小 `xinyun-ai/` 司令部。
+2. 项目识别：快速识别项目类型、多端结构、数据库、API、测试和配置线索。
+3. 按需理解：根据用户任务补全相关端、数据库、API 或问题理解。
+4. 方案确认：改代码前先输出方案，等待用户确认。
+5. 受控整改：只在确认范围内修改，不顺手重构。
+6. 技术沉淀：会话结束前筛选有价值内容，沉淀到 `xinyun-ai/`；经验先候选，确认后升级。
+
+## 执行模式
+
+如果项目没有 `xinyun-ai/`：
+
+- 使用 `templates/` 创建最小 `xinyun-ai/` 骨架。
+- 创建极简 `AGENTS.md`。
+- 做极速完整性检查。
+- 输出中文《项目导读》和初始化验收结果。
+
+如果项目已经有 `xinyun-ai/`：
+
+- 读取 `xinyun-ai/manifest.json`、`xinyun-ai/README.md`、`xinyun-ai/rules/core-rules.md`、`xinyun-ai/index/project-index.json`。
+- 对比 `xinyun-ai-init/version.json`。
+- 进入升级检查模式。
+- 输出升级方案。
+- 等用户确认后，只升级 `xinyun-ai/` 内相关文件，不修改业务代码。
+
+## 首次最小落盘
+
+首次只允许创建或补齐：
+
+```md
+AGENTS.md
+xinyun-ai/README.md
+xinyun-ai/manifest.json
+xinyun-ai/current-task.md
+xinyun-ai/rules/core-rules.md
+xinyun-ai/project/项目导读.md
+xinyun-ai/project/项目完整性检查.md
+xinyun-ai/workstreams/README.md
+xinyun-ai/index/project-index.json
+```
+
+首次不要创建大量规则、模板、脚本和业务沉淀目录。后续根据任务按需补齐。
+
+## 硬约束
+
+- 首次初始化只做极速接手，不做全量深度扫描，不追完整调用链。
+- 不修改业务代码、配置、数据库、依赖、构建脚本、测试逻辑或格式化结果。
+- 代码整改前必须先输出修改方案，等待用户明确确认后才能执行。
+- 不运行 install、build、format、自动修复、migration、seed、写数据库、生成业务文件等副作用命令。
+- 首次初始化不执行语言级语法检查、lint、typecheck、测试或构建命令，只记录是否发现相关命令。
+- 如果本机缺少 `php`、`node`、`python`、`java`、`go` 等运行时，不作为错误，只记录为 `本地运行时未确认` 或 `当前环境不可用`。
+- 涉及 SQL / 数据库改动时，必须单独输出 SQL 执行提醒。
+- 非项目开发内容不沉淀。
+- 敏感信息不泄露。
+
+## 巡检边界
+
+- 每个端最多读取 3-5 个关键文件。
+- 优先读取 README、包管理文件、框架配置、入口文件、路由入口、环境变量样例、数据库 schema/migration 目录名。
+- 不读取大目录和生成物：`node_modules`、`vendor`、`dist`、`build`、`.git`、`.codegraph`、`storage`、`runtime`、`unpackage`、`coverage`、`.next`、`.nuxt`。
+- 不确定的信息标注：`推断`、`待确认`、`未在项目中发现`。
+
+## 按需补齐
+
+后续识别到新端、模块或能力时，只在 `xinyun-ai/` 内补齐对应目录和说明文件。
+
+- 服务端：`xinyun-ai/workstreams/server/`
+- 后台：`xinyun-ai/workstreams/admin/`
+- 用户端：`xinyun-ai/workstreams/app/` 或 `user/`
+- SQL / 数据库：`xinyun-ai/database/`
+- API：`xinyun-ai/api/`
+- 问题排查：`xinyun-ai/problems/`
+- 需求：`xinyun-ai/requirements/`
+- 技术经验：`xinyun-ai/rules-candidates/`
+
+新目录创建后必须更新 `xinyun-ai/manifest.json` 和 `xinyun-ai/index/project-index.json`。
+
+## 会话工作台
+
+首次初始化不创建会话工作台。复杂任务中可按需创建：
+
+```md
+xinyun-ai/index/session-current.md
+```
+
+`session-current.md` 只记录本轮临时线索，不是项目事实源。会话结束前筛选：长期有价值的沉淀到正式目录，仅本轮有价值的写入 `sessions/`，无价值、误判、非项目内容不沉淀。
+
+## 自我学习
+
+AI 可以沉淀项目经验，但不能自己升级正式规则。
+
+```md
+发现可复用经验
+→ 记录为候选经验
+→ 会话总结中说明价值、来源和适用范围
+→ 等待用户确认
+→ 用户确认后再合并进 core-rules 或后续独立 rules 文件
+```
+
+## 最小校验
+
+- 创建或修改 `xinyun-ai/` 内 JSON 文件后，必须确认 JSON 可解析。
+- 创建或修改 `xinyun-ai/` 内 Markdown 文件后，只做基础格式检查：标题、列表、代码块是否闭合。
+- 不运行项目业务 lint、build、test、typecheck。
+
+## 输出要求
+
+初始化或升级完成后，输出：
+
+1. 当前执行模式：初始化 / 升级检查 / 部分完成 / 阻塞。
+2. 已创建或已更新的 `xinyun-ai/` 文件。
+3. 项目一句话概览。
+4. 识别到的端、模块、技术栈、本地启动线索。
+5. 数据库、API、测试体系发现情况。
+6. CodeGraph 与索引状态。
+7. 待确认问题。
+8. 后续日常开发和问题排查短指令。

package/init/xinyun-ai-init/prompt.md

@@ -0,0 +1 @@
+请读取当前项目根目录下的 `xinyun-ai-init/README.md`，按“欣芸技术开发 Agent 流”初始化或升级当前项目；未获确认前不要修改业务代码。

package/init/xinyun-ai-init/rules/directory-self-completion.md

@@ -0,0 +1,11 @@
+# 目录自完善规则
+
+首次初始化只创建最小 `xinyun-ai/` 骨架。后续 AI 会话中，如果用户需求、问题排查或项目理解触发了某个端、模块或能力，AI 应自动在 `xinyun-ai/` 下补齐对应目录和基础说明文件。
+
+规则：
+
+- 只补齐当前任务涉及的目录，不为了完整创建所有目录。
+- 只允许补齐 `xinyun-ai/` 内的文档、索引和记录，不修改业务代码。
+- 新目录创建后必须更新 `manifest.json` 和 `index/project-index.json`。
+- 自完善内容必须标注来源、判断依据和状态：`推断`、`已确认`、`待确认`。
+- 如果自完善会改变正式规则、开发流程或代码修改策略，必须先输出方案并等待用户确认。

package/init/xinyun-ai-init/rules/init-rules.md

@@ -0,0 +1,7 @@
+# 初始化规则
+
+- 首次只创建最小 `xinyun-ai/` 骨架和极简 `AGENTS.md`。
+- 首次不创建大量规则、模板、脚本和业务沉淀目录。
+- 首次不执行语言级语法检查、lint、typecheck、测试或构建命令。
+- 每个端最多读取 3-5 个关键文件。
+- 不确定的信息标注：`推断`、`待确认`、`未在项目中发现`。

package/init/xinyun-ai-init/rules/self-learning-rules.md

@@ -0,0 +1,15 @@
+# 自我学习规则
+
+AI 可以沉淀项目经验，但不能自己升级正式规则。
+
+流程：
+
+```md
+发现可复用经验
+→ 记录为候选经验
+→ 会话总结中说明价值、来源和适用范围
+→ 等待用户确认
+→ 用户确认后再合并进 core-rules 或后续独立 rules 文件
+```
+
+候选经验必须标注来源、适用范围、可信度、状态和最后验证时间。

package/init/xinyun-ai-init/rules/session-workbench.md

@@ -0,0 +1,15 @@
+# 会话工作台规则
+
+首次初始化不创建会话工作台。复杂任务中可按需创建：
+
+```md
+xinyun-ai/index/session-current.md
+```
+
+规则：
+
+- `session-current.md` 只记录本轮临时线索，不是项目事实源。
+- 不记录非项目内容、闲聊、敏感值。
+- 不记录完整搜索流水账，只记录关键文件、关键发现、待确认点、候选沉淀。
+- 会话结束前必须筛选：长期有价值的沉淀到正式目录；仅本轮有价值的写入 `sessions/`；无价值、误判、非项目内容不沉淀。
+- 筛选完成后更新 `index/project-index.json`。

package/init/xinyun-ai-init/rules/upgrade-rules.md

@@ -0,0 +1,15 @@
+# 升级规则
+
+如果项目已存在 `xinyun-ai/`，不要重复初始化，应进入升级检查模式。
+
+升级流程：
+
+1. 读取 `xinyun-ai/manifest.json`、`README.md`、`rules/core-rules.md`、`index/project-index.json`。
+2. 读取 `xinyun-ai-init/version.json`。
+3. 对比版本和缺失能力。
+4. 输出升级方案。
+5. 等用户确认后，只更新 `xinyun-ai/` 内相关文件。
+6. 不修改业务代码、配置、数据库、依赖、构建脚本、测试逻辑。
+7. 升级完成后按需写入 `xinyun-ai/upgrade-log.md`。
+
+涉及正式规则、目录结构、索引结构或历史沉淀迁移时，必须先确认。

package/init/xinyun-ai-init/scripts/README.md

@@ -0,0 +1,7 @@
+# scripts
+
+本初始化包默认不执行脚本。
+
+如果后续需要脚本，只允许先用于 `xinyun-ai/` 内模板生成、索引更新或格式校验。
+
+任何会修改业务代码、数据库、依赖、配置、构建、格式化、自动修复、联网下载的脚本，都必须先输出方案并等待用户确认。

package/init/xinyun-ai-init/templates/AGENTS.template.md

@@ -0,0 +1,13 @@
+# AGENTS.md
+
+本项目使用 `xinyun-ai/` 管理 AI 协作规则。
+
+AI 接手本项目时，请先读取：
+
+- `xinyun-ai/README.md`
+- `xinyun-ai/manifest.json`
+- `xinyun-ai/current-task.md`
+- `xinyun-ai/rules/core-rules.md`
+- `xinyun-ai/index/project-index.json`
+
+未获用户确认前，不要修改业务代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程。

package/init/xinyun-ai-init/templates/README.template.md

@@ -0,0 +1,19 @@
+# xinyun-ai 工作区
+
+本目录是当前项目的 AI 协作工作区，采用“欣芸技术开发 Agent 流”。
+
+## 工作方式
+
+- 首次初始化为极速模式，后续能力按需补齐。
+- 后续 AI 会话优先读取 `manifest.json`、`current-task.md`、`rules/core-rules.md`、`index/project-index.json`。
+- 业务代码、配置、数据库、API、UI、业务流程修改前必须先出计划并等待确认。
+- 后续识别到新端、模块或能力时，只在 `xinyun-ai/` 内按需补齐对应目录和说明文件。
+
+## 核心流程
+
+1. 极速初始化
+2. 项目识别
+3. 按需理解
+4. 方案确认
+5. 受控整改
+6. 技术沉淀

package/init/xinyun-ai-init/templates/core-rules.template.md

@@ -0,0 +1,30 @@
+# xinyun-ai 核心规则
+
+## 硬约束
+
+- 只读优先，禁止副作用命令。
+- 代码整改前必须先给修改方案，待用户确认后才能执行。
+- SQL / 数据库改动必须重点提醒。
+- 非项目内容不沉淀。
+- 多端项目按 `workstreams/<端名称>/` 分开说明。
+- 旧 AI 记录只审计，不默认相信、不覆盖。
+- CodeGraph 不可擅自初始化。
+- 敏感信息不泄露。
+- 自我学习只沉淀候选经验，不自动改正式规则。
+- 目录自完善只补 `xinyun-ai/` 文档和索引，不修改业务代码。
+
+## 理解深度状态
+
+- `unknown`：未识别
+- `quick`：首次快速识别
+- `expanded`：已按任务补全理解
+- `verified`：已结合代码或索引验证
+- `stale`：疑似过期
+
+## 会话工作台
+
+复杂任务可按需创建 `xinyun-ai/index/session-current.md`。该文件只记录本轮临时线索，不是项目事实源。
+
+## 自我学习
+
+发现可复用经验时，先记录为候选经验。候选经验必须标注来源、适用范围、可信度、状态和最后验证时间。用户确认后，才能合并进正式规则。

package/init/xinyun-ai-init/templates/current-task.template.md

@@ -0,0 +1,7 @@
+# 当前任务
+
+- 状态：初始化
+- 用户原始需求：
+- 影响端：
+- 待确认问题：
+- 本轮沉淀位置：

package/init/xinyun-ai-init/templates/manifest.template.json

@@ -0,0 +1,17 @@
+{
+  "projectName": "",
+  "xinyunAiVersion": "1.0.0",
+  "scriptVersion": "2026.07.10",
+  "schemaVersion": "1",
+  "initializationMode": "fast",
+  "expansionMode": "triggered",
+  "currentTask": "xinyun-ai/current-task.md",
+  "understanding": {
+    "overall": "quick",
+    "workstreams": {},
+    "database": "unknown",
+    "api": "unknown"
+  },
+  "codegraph": { "enabled": false, "status": "unknown" },
+  "index": { "primary": "json_markdown", "sqlite": "optional" }
+}

package/init/xinyun-ai-init/templates/project-check.template.md

@@ -0,0 +1,22 @@
+# 项目完整性检查
+
+## 检查范围
+
+首次只做极速检查，每个端最多读取 3-5 个关键文件。
+
+## 检查结果
+
+- 当前目录是否像真实项目：待填写
+- 技术栈、包管理器、运行环境：待填写
+- 多端或多模块结构：待填写
+- 本地启动、构建、测试、lint、typecheck 命令：待填写
+- 数据库相关线索：待填写
+- API 相关线索：待填写
+- 配置线索：待填写
+- 测试体系线索：待填写
+- 权限与安全线索：待填写
+- 已有 AI 痕迹：待填写
+
+## 待确认问题
+
+待填写。

package/init/xinyun-ai-init/templates/project-guide.template.md

@@ -0,0 +1,41 @@
+# 项目导读
+
+## 项目一句话概览
+
+待填写。
+
+## 当前项目状态判断
+
+待填写。
+
+## 项目完整性检查结果
+
+待填写。
+
+## 已有 AI 接手痕迹与历史沉淀审计
+
+待填写。
+
+## 端、模块、技术栈与本地启动方式
+
+待填写。
+
+## 数据库、API、测试体系发现情况
+
+待填写。
+
+## xinyun-ai 初始化结果
+
+待填写。
+
+## CodeGraph 与索引状态
+
+待填写。
+
+## 待确认问题
+
+待填写。
+
+## 后续短指令
+
+待填写。

package/init/xinyun-ai-init/templates/project-index.template.json

@@ -0,0 +1,13 @@
+{
+  "projectSummary": "",
+  "understanding": {
+    "overall": "quick",
+    "workstreams": {},
+    "database": "unknown",
+    "api": "unknown"
+  },
+  "database": "unknown",
+  "api": "unknown",
+  "tests": "unknown",
+  "lastUpdatedAt": ""
+}

package/init/xinyun-ai-init/templates/workstreams-readme.template.md

@@ -0,0 +1,17 @@
+# workstreams
+
+本目录用于按端或子系统沉淀技术执行说明。
+
+首次初始化只记录识别到的端，不创建所有端目录。
+
+## 理解深度状态
+
+- `unknown`：未识别
+- `quick`：首次快速识别
+- `expanded`：已按任务补全理解
+- `verified`：已结合代码或索引验证
+- `stale`：疑似过期
+
+## 已识别端
+
+待填写。

package/init/xinyun-ai-init/version.json

@@ -0,0 +1,10 @@
+{
+  "packageName": "xinyun-ai-init",
+  "displayName": "欣芸技术开发 Agent 流初始化包",
+  "version": "1.0.0",
+  "scriptVersion": "2026.07.10",
+  "schemaVersion": "1",
+  "defaultMode": "fast-init",
+  "targetWorkspace": "xinyun-ai",
+  "encoding": "UTF-8 with BOM"
+}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@pm_zhousl/xinyun-ai-init",
+  "version": "1.0.0",
+  "description": "欣芸技术开发 Agent 流初始化包",
+  "bin": {
+    "xinyun-ai-init": "bin/xinyun-ai-init.js"
+  },
+  "files": [
+    "bin/",
+    "init/",
+    "README.md"
+  ],
+  "keywords": [
+    "xinyun-ai",
+    "codex",
+    "ai-agent",
+    "project-init"
+  ],
+  "author": "pm_zhousl",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16"
+  }
+}