@wdyy/skills 0.1.2 → 0.1.4

package/README.md

@@ -29,7 +29,7 @@ npm install -g @wdyy/skills
 wdyy init
 ```
 
-`wdyy init` 自动执行 `openspec init`，将 5 个受管理 Skill 安装到 `.agents/skills/`，并在 `docs/bug_record.md` 创建或追加 BUG 记录模板。若目标项目已有 `AGENTS.md`，原文件保持不变，命令将生成 `AGENTS_new.md`；每次运行都会覆盖更新 `.agents/skills/wdyy-*`，但不修改同级自定义 Skill。
+`wdyy init` 会在系统用户目录 `.agents/skills/` 安装或更新 5 个受管理 Skill，不在目标项目创建 `.agents/skills/`。它还会执行 `git init`，创建或补齐 `.gitignore` 的 `.env`、`node_modules/`、`venv/`、`.pnpm-store/`、`logs/`、`dist/`、`.DS_Store`、`*.tar.gz` 规则，创建 `src/frontend`、`src/backend`、`database`、`deploy`、`docs`、`scripts`、`tests` 和空 `.env.example`，并执行 `openspec init`、创建或追加 `docs/bug_record.md` 模板。若目标项目已有 `AGENTS.md`，原文件保持不变，命令将生成 `AGENTS_new.md`。
 
 ### 仅更新已安装的 Skill
 
@@ -41,9 +41,9 @@ wdyy update-skill wdyy-logging-standard
 wdyy update-skill --all
 ```
 
-`wdyy update-skill <skill-name>` 只接受 5 个受管理的 `wdyy-*` Skill，且仅替换指定目录；`--all` 替换全部 5 个受管理 Skill。两种方式都不会写入 `AGENTS.md` 或 `AGENTS_new.md`、追加 `docs/bug_record.md`，也不会执行 `openspec init`。首次初始化或需要重新生成项目规则时，使用 `wdyy init`。
+`wdyy update-skill <skill-name>` 只接受 5 个受管理的 `wdyy-*` Skill，且仅替换系统用户目录 `.agents/skills/` 中的指定目录；`--all` 替换全部 5 个受管理 Skill。两种方式都不会写入调用项目的 `AGENTS.md`、`AGENTS_new.md`、`docs/bug_record.md` 或 `.agents/skills/`，也不会执行 `openspec init`。首次初始化或需要重新生成项目规则时，使用 `wdyy init`。
 
-中大型变更先使用 `/opsx:explore` 或 `/opsx:propose <change-name>`，在方案确认后使用 `/opsx:apply`；完成验证后使用 `/opsx:archive`。涉及数据库、内部 API、日志、部署时，按 `AGENTS.md` 的路由加载相应企业 Skill。配置仅从环境变量读取，不得提交秘密或生产环境 `.env`。
+中大型变更先使用 `/opsx:explore` 或 `/opsx:propose <change-name>`，在方案确认后使用 `/opsx:apply`；完成验证后使用 `/opsx:archive`。涉及数据库、内部 API、日志、部署时，按 `AGENTS.md` 的路由加载相应企业 Skill。所有 URL、端口和 IP 地址从 `.env` 读取，不得硬编码；不得提交秘密或生产环境 `.env`。项目完成后创建 `README.md`，说明技术栈、目录结构和安装部署。
 
 ## 固定技术栈
 

package/lib/wdyy-cli.js

@@ -1,5 +1,6 @@
 import { spawnSync } from 'node:child_process';
 import { access, appendFile, cp, mkdir, mkdtemp, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
@@ -12,6 +13,29 @@ const managedSkillNames = [
   'wdyy-deployment-standard'
 ];
 
+const defaultProjectDirectories = [
+  'src/frontend',
+  'src/backend',
+  'database',
+  'deploy',
+  'docs',
+  'scripts',
+  'tests'
+];
+
+const requiredGitIgnoreEntries = [
+  '.env',
+  'node_modules/',
+  'venv/',
+  '.pnpm-store/',
+  'logs/',
+  'dist/',
+  '.DS_Store',
+  '*.tar.gz'
+];
+
+const defaultProjectLayout = [...defaultProjectDirectories, '.env.example'];
+
 const generatedAgentsContent = `# 企业开发规则
 
 本项目同时使用OpenSpec及企业 Skill统一开发规则及流程。
@@ -23,9 +47,11 @@ const generatedAgentsContent = `# 企业开发规则
 - 后端：NestJS。
 - 数据库：PostgreSQL 18。
 
-默认项目目录为 \`src/frontend\`、\`src/backend\`、\`database\`、\`deploy\`、\`docs\`、\`scripts\`、\`tests\`、\`.env.example\`。
+默认项目目录为 ${defaultProjectLayout.map((path) => `\`${path}\``).join('、')}。
 
-配置仅从环境变量读取；不得提交秘密或生产环境 \`.env\`。
+所有 URL、端口和 IP 地址必须从 \`.env\` 文件读取，禁止在代码中硬编码；不得提交秘密或生产环境 \`.env\`。
+
+项目开发完成后必须创建 \`README.md\`，内容包括项目技术栈、目录结构和安装部署说明。
 
 ## Skill 路由
 
@@ -54,8 +80,7 @@ function printHelp() {
   console.log('仅更新当前项目的一个或全部受管理 wdyy Skill，不执行项目初始化。');
 }
 
-async function installManagedSkills(targetRoot, writtenPaths, skillNames = managedSkillNames) {
-  const skillsRoot = join(targetRoot, '.agents', 'skills');
+async function installManagedSkills(skillsRoot, writtenPaths, skillNames = managedSkillNames) {
   await mkdir(skillsRoot, { recursive: true });
   const temporaryRoot = await mkdtemp(join(skillsRoot, '.wdyy-skills-'));
 
@@ -78,6 +103,72 @@ async function installManagedSkills(targetRoot, writtenPaths, skillNames = manag
   }
 }
 
+function getGlobalSkillsRoot() {
+  return join(homedir(), '.agents', 'skills');
+}
+
+function printWrittenPaths(writtenPaths) {
+  if (writtenPaths.length > 0) console.error(`已写入路径:\n${writtenPaths.map((path) => `- ${path}`).join('\n')}`);
+}
+
+function initializeGit(targetRoot, writtenPaths) {
+  const result = spawnSync('git', ['init'], { cwd: targetRoot, stdio: 'inherit' });
+  if (result.error || result.status !== 0) {
+    const detail = result.error?.message ?? `退出码 ${result.status ?? 1}`;
+    console.error(`Git 初始化失败: ${detail}`);
+    printWrittenPaths(writtenPaths);
+    return result.status ?? 1;
+  }
+
+  writtenPaths.push(join(targetRoot, '.git'));
+  console.log('Git 初始化完成。');
+  return 0;
+}
+
+async function appendGitIgnoreEntries(targetRoot, writtenPaths) {
+  const gitIgnorePath = join(targetRoot, '.gitignore');
+  let existing = '';
+  try {
+    existing = await readFile(gitIgnorePath, 'utf8');
+  } catch (error) {
+    if (error.code !== 'ENOENT') throw error;
+  }
+
+  const existingEntries = new Set(existing.split(/\r?\n/).map((entry) => entry.trim()).filter(Boolean));
+  const missingEntries = requiredGitIgnoreEntries.filter((entry) => !existingEntries.has(entry));
+  if (missingEntries.length === 0 && existing.length > 0) return;
+
+  const prefix = existing.length === 0 ? '' : existing.endsWith('\n') ? '' : '\n';
+  await appendFile(gitIgnorePath, `${prefix}${missingEntries.join('\n')}\n`, 'utf8');
+  writtenPaths.push(gitIgnorePath);
+  console.log(`已更新 Git 忽略规则: ${gitIgnorePath}`);
+}
+
+async function createDefaultProjectLayout(targetRoot, writtenPaths) {
+  for (const directory of defaultProjectDirectories) {
+    const destination = join(targetRoot, directory);
+    let existed = true;
+    try {
+      await access(destination);
+    } catch (error) {
+      if (error.code !== 'ENOENT') throw error;
+      existed = false;
+    }
+    await mkdir(destination, { recursive: true });
+    if (!existed) writtenPaths.push(destination);
+  }
+
+  const envExamplePath = join(targetRoot, '.env.example');
+  try {
+    await access(envExamplePath);
+  } catch (error) {
+    if (error.code !== 'ENOENT') throw error;
+    await writeFile(envExamplePath, '', 'utf8');
+    writtenPaths.push(envExamplePath);
+  }
+  console.log(`已准备默认项目目录: ${defaultProjectDirectories.join('、')}`);
+}
+
 async function writeAgentsFile(targetRoot, writtenPaths) {
   const agentsPath = join(targetRoot, 'AGENTS.md');
   let destination = agentsPath;
@@ -115,7 +206,7 @@ function initializeOpenSpec(targetRoot, writtenPaths) {
   if (result.error || result.status !== 0) {
     const detail = result.error?.message ?? `退出码 ${result.status ?? 1}`;
     console.error(`OpenSpec 初始化失败: ${detail}`);
-    console.error(`已写入路径:\n${writtenPaths.map((path) => `- ${path}`).join('\n')}`);
+    printWrittenPaths(writtenPaths);
     return result.status ?? 1;
   }
 
@@ -127,8 +218,12 @@ export async function run(argumentsList) {
   if (argumentsList.length === 1 && argumentsList[0] === 'init') {
     const writtenPaths = [];
     try {
+      const gitExitCode = initializeGit(process.cwd(), writtenPaths);
+      if (gitExitCode !== 0) return gitExitCode;
       await writeAgentsFile(process.cwd(), writtenPaths);
-      await installManagedSkills(process.cwd(), writtenPaths);
+      await installManagedSkills(getGlobalSkillsRoot(), writtenPaths);
+      await appendGitIgnoreEntries(process.cwd(), writtenPaths);
+      await createDefaultProjectLayout(process.cwd(), writtenPaths);
       await appendBugRecordTemplate(process.cwd(), writtenPaths);
       const openSpecExitCode = initializeOpenSpec(process.cwd(), writtenPaths);
       if (openSpecExitCode !== 0) return openSpecExitCode;
@@ -136,7 +231,7 @@ export async function run(argumentsList) {
       return 0;
     } catch (error) {
       console.error(`wdyy 初始化失败: ${error.message}`);
-      if (writtenPaths.length > 0) console.error(`已写入路径:\n${writtenPaths.map((path) => `- ${path}`).join('\n')}`);
+      printWrittenPaths(writtenPaths);
       return 1;
     }
   }
@@ -156,11 +251,11 @@ export async function run(argumentsList) {
 
     const writtenPaths = [];
     try {
-      await installManagedSkills(process.cwd(), writtenPaths, skillNames);
+      await installManagedSkills(getGlobalSkillsRoot(), writtenPaths, skillNames);
       return 0;
     } catch (error) {
       console.error(`Skill 更新失败: ${error.message}`);
-      if (writtenPaths.length > 0) console.error(`已写入路径:\n${writtenPaths.map((path) => `- ${path}`).join('\n')}`);
+      printWrittenPaths(writtenPaths);
       return 1;
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wdyy/skills",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "企业内部开发 Skill 与项目初始化命令",
   "type": "module",
   "bin": {