@chongyan/autospec 1.0.1

package/scripts/cli/org.js

@@ -0,0 +1,340 @@
+/**
+ * AutoSpec org command
+ *
+ * 实现 autospec org 子命令
+ * 支持 init/list/members 操作
+ */
+
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import chalk from 'chalk';
+import {
+  ORG_AUTOSPEC_DIR,
+  ORG_AUTOSPEC_SUBDIRS
+} from '../install/constants.js';
+
+/**
+ * 获取组织知识库根目录
+ */
+function getOrgDir(orgName) {
+  return path.join(os.homedir(), ORG_AUTOSPEC_DIR, orgName);
+}
+
+/**
+ * 获取组织列表文件路径
+ */
+function getOrgListPath() {
+  return path.join(os.homedir(), ORG_AUTOSPEC_DIR, 'orgs.json');
+}
+
+/**
+ * 创建目录
+ */
+function ensureDir(dir) {
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+}
+
+/**
+ * 安全读取 JSON
+ */
+function safeReadJson(filePath, defaultValue = null) {
+  try {
+    if (!fs.existsSync(filePath)) {
+      return defaultValue;
+    }
+    return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+  } catch (e) {
+    return defaultValue;
+  }
+}
+
+/**
+ * 安全写入 JSON
+ */
+function safeWriteJson(filePath, data) {
+  try {
+    const dir = path.dirname(filePath);
+    ensureDir(dir);
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2));
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+/**
+ * 初始化组织知识库
+ */
+export function initOrg(orgName, options = {}) {
+  const orgDir = getOrgDir(orgName);
+  const results = {
+    orgCreated: false,
+    directoriesCreated: false,
+    errors: []
+  };
+
+  console.log(chalk.bold('\n  AutoSpec Org Init\n'));
+  console.log(`  Organization: ${orgName}`);
+  console.log(`  Target: ${orgDir}`);
+  console.log();
+
+  try {
+    // 创建组织目录结构
+    const subdirs = Object.values(ORG_AUTOSPEC_SUBDIRS);
+    for (const subdir of subdirs) {
+      const fullPath = path.join(orgDir, subdir);
+      ensureDir(fullPath);
+    }
+    results.directoriesCreated = true;
+
+    // 注册组织
+    const orgListPath = getOrgListPath();
+    const orgList = safeReadJson(orgListPath, { orgs: [] });
+
+    // 检查是否已存在
+    if (orgList.orgs.find(o => o.name === orgName)) {
+      console.log(chalk.yellow(`  ⚠ 组织 ${orgName} 已存在`));
+      return results;
+    }
+
+    // 添加组织
+    orgList.orgs.push({
+      name: orgName,
+      createdAt: new Date().toISOString(),
+      ...options
+    });
+    safeWriteJson(orgListPath, orgList);
+
+    results.orgCreated = true;
+
+    console.log(chalk.green('  ✓') + ` 组织 ${orgName} 已创建`);
+    console.log(chalk.green('  ✓') + ' 目录结构已创建');
+
+    console.log(chalk.bold('\n  快速开始\n'));
+    console.log('  组织知识库已初始化，您可以通过以下命令使用：');
+    console.log('');
+    console.log(chalk.cyan('  发布技能到组织'));
+    console.log(`    autospec org publish ${orgName} <skill-name>`);
+    console.log('');
+    console.log(chalk.cyan('  查看组织列表'));
+    console.log('    autospec org list');
+    console.log('');
+
+    return results;
+  } catch (e) {
+    results.errors.push(e.message);
+    console.log(chalk.red(`  ✗ 初始化失败: ${e.message}`));
+    return results;
+  }
+}
+
+/**
+ * 列出所有组织
+ */
+export function listOrgs(options = {}) {
+  const orgListPath = getOrgListPath();
+  const orgList = safeReadJson(orgListPath, { orgs: [] });
+
+  console.log(chalk.bold('\n  AutoSpec Org List\n'));
+
+  if (orgList.orgs.length === 0) {
+    console.log(chalk.yellow('  暂无组织'));
+    console.log(chalk.cyan('  运行 autospec org init <org-name> 创建组织'));
+    return { orgs: [] };
+  }
+
+  console.log(`  共 ${orgList.orgs.length} 个组织:\n`);
+
+  for (const org of orgList.orgs) {
+    const orgDir = getOrgDir(org.name);
+    const skillsDir = path.join(orgDir, ORG_AUTOSPEC_SUBDIRS.SKILLS);
+
+    let skillCount = 0;
+    if (fs.existsSync(skillsDir)) {
+      skillCount = fs.readdirSync(skillsDir).filter(f =>
+        fs.statSync(path.join(skillsDir, f)).isDirectory()
+      ).length;
+    }
+
+    console.log(`  ${chalk.cyan(org.name)}`);
+    console.log(`    创建于: ${org.createdAt}`);
+    console.log(`    Skills: ${skillCount}`);
+    console.log('');
+  }
+
+  return { orgs: orgList.orgs };
+}
+
+/**
+ * 获取组织成员
+ */
+export function listOrgMembers(orgName, options = {}) {
+  const orgDir = getOrgDir(orgName);
+  const membersFile = path.join(orgDir, 'members.json');
+  const members = safeReadJson(membersFile, { members: [] });
+
+  console.log(chalk.bold(`\n  AutoSpec Org Members: ${orgName}\n`));
+
+  if (members.members.length === 0) {
+    console.log(chalk.yellow('  暂无成员'));
+    return { members: [] };
+  }
+
+  for (const member of members.members) {
+    console.log(`  ${chalk.cyan(member.name)} - ${member.role || 'member'}`);
+  }
+  console.log('');
+
+  return { members: members.members };
+}
+
+/**
+ * 添加组织成员
+ */
+export function addOrgMember(orgName, memberName, options = {}) {
+  const { role = 'member' } = options;
+  const orgDir = getOrgDir(orgName);
+  const membersFile = path.join(orgDir, 'members.json');
+
+  const members = safeReadJson(membersFile, { members: [] });
+
+  // 检查是否已存在
+  if (members.members.find(m => m.name === memberName)) {
+    console.log(chalk.yellow(`  ⚠ 成员 ${memberName} 已存在`));
+    return { success: false, error: 'Member already exists' };
+  }
+
+  members.members.push({
+    name: memberName,
+    role,
+    addedAt: new Date().toISOString()
+  });
+
+  safeWriteJson(membersFile, members);
+
+  console.log(chalk.green('  ✓') + ` 成员 ${memberName} 已添加到组织 ${orgName}`);
+  return { success: true, memberName, role };
+}
+
+/**
+ * 发布技能到组织
+ */
+export function publishToOrg(orgName, skillName, options = {}) {
+  const { version = '1.0.0', message = '' } = options;
+  const orgDir = getOrgDir(orgName);
+  const skillsDir = path.join(orgDir, ORG_AUTOSPEC_SUBDIRS.SKILLS);
+
+  console.log(chalk.bold('\n  AutoSpec Org Publish\n'));
+  console.log(`  Organization: ${orgName}`);
+  console.log(`  Skill: ${skillName}`);
+  console.log(`  Version: ${version}`);
+  console.log();
+
+  try {
+    // 从项目或源码获取技能
+    const projectSkillsDir = path.join(process.cwd(), 'plugins', 'skills', skillName);
+    const projectSkillFile = path.join(projectSkillsDir, 'SKILL.md');
+    const sourceSkillsDir = path.join(process.cwd(), 'plugins', 'skills');
+    const sourceSkillFile = path.join(sourceSkillsDir, skillName, 'SKILL.md');
+
+    let skillContent = null;
+    let sourcePath = null;
+
+    if (fs.existsSync(projectSkillFile)) {
+      skillContent = fs.readFileSync(projectSkillFile, 'utf-8');
+      sourcePath = projectSkillsDir;
+    } else if (fs.existsSync(sourceSkillFile)) {
+      skillContent = fs.readFileSync(sourceSkillFile, 'utf-8');
+      sourcePath = path.join(sourceSkillsDir, skillName);
+    }
+
+    if (!skillContent) {
+      console.log(chalk.red(`  ✗ 技能 ${skillName} 不存在`));
+      return { success: false, error: 'Skill not found' };
+    }
+
+    // 创建技能目录
+    const targetSkillDir = path.join(skillsDir, skillName, `v${version}`);
+    ensureDir(targetSkillDir);
+
+    // 写入技能文件
+    const targetSkillFile = path.join(targetSkillDir, 'SKILL.md');
+    fs.writeFileSync(targetSkillFile, skillContent);
+
+    // 复制 references 目录（如果存在）
+    const sourceRefsDir = path.join(sourcePath, 'references');
+    if (fs.existsSync(sourceRefsDir)) {
+      const targetRefsDir = path.join(targetSkillDir, 'references');
+      const { copyDirSync } = require('../install/index.js');
+      copyDirSync(sourceRefsDir, targetRefsDir);
+    }
+
+    console.log(chalk.green('  ✓') + ` 技能 ${skillName} v${version} 已发布到组织 ${orgName}`);
+    console.log(`    Path: ${targetSkillFile}`);
+    console.log('');
+
+    return { success: true, orgName, skillName, version, path: targetSkillFile };
+  } catch (e) {
+    console.log(chalk.red(`  ✗ 发布失败: ${e.message}`));
+    return { success: false, error: e.message };
+  }
+}
+
+/**
+ * org 命令入口
+ */
+export function orgCommand(action, params, options = {}) {
+  switch (action) {
+    case 'init':
+      if (!params[0]) {
+        console.log(chalk.red('  ✗ 请指定组织名称'));
+        console.log('  用法: autospec org init <org-name>');
+        return { success: false, error: 'Org name required' };
+      }
+      return initOrg(params[0], options);
+
+    case 'list':
+      return listOrgs(options);
+
+    case 'members':
+      if (!params[0]) {
+        console.log(chalk.red('  ✗ 请指定组织名称'));
+        console.log('  用法: autospec org members <org-name>');
+        return { success: false, error: 'Org name required' };
+      }
+      return listOrgMembers(params[0], options);
+
+    case 'add-member':
+      if (!params[0] || !params[1]) {
+        console.log(chalk.red('  ✗ 参数不完整'));
+        console.log('  用法: autospec org add-member <org-name> <member-name>');
+        return { success: false, error: 'Missing parameters' };
+      }
+      return addOrgMember(params[0], params[1], options);
+
+    case 'publish':
+      if (!params[0] || !params[1]) {
+        console.log(chalk.red('  ✗ 参数不完整'));
+        console.log('  用法: autospec org publish <org-name> <skill-name>');
+        return { success: false, error: 'Missing parameters' };
+      }
+      return publishToOrg(params[0], params[1], options);
+
+    default:
+      console.log(chalk.red(`  ✗ 未知操作: ${action}`));
+      console.log('  可用操作: init, list, members, add-member, publish');
+      return { success: false, error: 'Unknown action' };
+  }
+}
+
+export default {
+  initOrg,
+  listOrgs,
+  listOrgMembers,
+  addOrgMember,
+  publishToOrg,
+  orgCommand
+};

package/scripts/cli/update.js

@@ -0,0 +1,44 @@
+/**
+ * autospec update command
+ */
+
+import chalk from 'chalk';
+import path from 'path';
+import fs from 'fs';
+import { initProject } from './init.js';
+
+export function updateCommand() {
+  const targetDir = process.cwd();
+  const autospecDir = path.join(targetDir, '.autospec');
+
+  if (!fs.existsSync(autospecDir)) {
+    console.log(chalk.red('\nAutoSpec not initialized in this project.'));
+    console.log('Run: autospec init\n');
+    return;
+  }
+
+  console.log(chalk.bold('\n🔄 AutoSpec Update\n'));
+
+  // Load existing config
+  const configPath = path.join(autospecDir, 'config.json');
+  let options = {};
+  if (fs.existsSync(configPath)) {
+    options = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+  }
+
+  const result = initProject(targetDir, options);
+
+  if (result.frameworkCopied) {
+    console.log(chalk.green('✓') + ' Knowledge files updated');
+  }
+  if (result.commandsGenerated) {
+    console.log(chalk.green('✓') + ' Claude Code commands regenerated');
+  }
+
+  if (result.errors.length > 0) {
+    result.errors.forEach(e => console.log(chalk.red('  ✗ ' + e)));
+  }
+
+  console.log(chalk.dim('\nState file preserved.'));
+  console.log('');
+}

package/scripts/config/commands.config.js

@@ -0,0 +1,145 @@
+/**
+ * AutoSpec 命令生成配置
+ *
+ * 声明式配置命令结构和模板，支持变量替换。
+ */
+
+// 用户输入块模板 — 注入到每个命令
+export const USER_INPUT_BLOCK = `## 用户输入
+
+\`\`\`
+$ARGUMENTS
+\`\`\`
+
+如果上方有用户输入内容，将其作为**本命令的补充上下文**：
+- 作为本阶段的任务描述、意图说明或额外约束
+- 如果包含特殊指示（如"用TypeScript"、"关注性能"、"跳过CEO探索"），在本阶段执行中遵循
+- 如果为空，按正常流程执行`;
+
+/**
+ * 命令定义配置
+ */
+export const COMMAND_DEFINITIONS = {
+  // ============================================================
+  // 核心流程命令
+  // ============================================================
+  run: {
+    description: '启动或恢复AutoSpec自主研发流程。统一控制瀑布迭代/敏捷迭代/实验模式/热修复四种模式，无人值守执行。',
+    templateFile: 'run.md'
+  },
+  explore: {
+    description: '"我先想想…" — 需求探索阶段。包含CEO想法对齐 + 需求分析。',
+    templateFile: 'explore.md'
+  },
+  propose: {
+    description: '"就这么干，方案写下来" — 方案设计阶段。包含技术方案设计。',
+    templateFile: 'propose.md'
+  },
+  apply: {
+    description: '"开工，按单子做" — 实施阶段。包含编码实现 + 代码审查 + QA测试。',
+    templateFile: 'apply.md'
+  },
+  archive: {
+    description: '"做完了，收工归档" — 交付归档阶段。包含交付部署 + 自进化归档。',
+    templateFile: 'archive.md'
+  },
+
+  // ============================================================
+  // 状态与验证命令
+  // ============================================================
+  status: {
+    description: '查看当前AutoSpec流程状态，AI提供下一步建议',
+    templateFile: 'status.md'
+  },
+  review: {
+    description: '审查各阶段交付物（需求/设计/代码/测试），评估产出质量',
+    templateFile: 'review.md'
+  },
+  validate: {
+    description: '运行Layer1确定性验证，AI分析结果并提供修复建议',
+    templateFile: 'validate.md'
+  },
+
+  // ============================================================
+  // 环境管理命令
+  // ============================================================
+  env: {
+    description: '查看当前环境配置状态',
+    templateFile: 'env.md'
+  },
+  'env-validate': {
+    description: '验证环境知识配置的完整性和有效性',
+    templateFile: 'env-validate.md'
+  },
+  'env-sync': {
+    description: '同步环境知识 - 本地扫描或从 Git/在线文档/npm 导入',
+    templateFile: 'env-sync.md'
+  },
+  'env-export': {
+    description: '导出当前项目的知识库',
+    templateFile: 'env-export.md'
+  },
+  'env-template': {
+    description: '查看和管理环境知识模板',
+    templateFile: 'env-template.md'
+  },
+  'env-update': {
+    description: '将本地环境知识变更提交到知识源（Git/在线文档/本地文件）',
+    templateFile: 'env-update.md'
+  },
+
+  // ============================================================
+  // 记忆管理命令
+  // ============================================================
+  memory: {
+    description: '管理项目记忆系统 - 查看状态、搜索记忆、手动添加记忆、导出导入',
+    templateFile: 'memory.md'
+  },
+
+  // ============================================================
+  // 自进化命令
+  // ============================================================
+  'project-evolve': {
+    description: 'AI Native 项目自我进化：智能感知、自动评测、自适应修复',
+    templateFile: 'project-evolve.md'
+  },
+  'field-evolve': {
+    description: '实战项目自进化：执行 benchmarks、评估分析、自动修复和技能蒸馏',
+    templateFile: 'field-evolve.md'
+  }
+
+  };
+
+/**
+ * 获取命令定义
+ */
+export function getCommandDefinition(name) {
+  return COMMAND_DEFINITIONS[name];
+}
+
+/**
+ * 获取所有命令名称
+ */
+export function getAllCommandNames() {
+  return Object.keys(COMMAND_DEFINITIONS);
+}
+
+/**
+ * 变量替换函数
+ */
+export function replaceVariables(template, variables) {
+  let result = template;
+  for (const [key, value] of Object.entries(variables)) {
+    const regex = new RegExp(`\\$\\{${key}\\}`, 'g');
+    result = result.replace(regex, value);
+  }
+  return result;
+}
+
+export default {
+  USER_INPUT_BLOCK,
+  COMMAND_DEFINITIONS,
+  getCommandDefinition,
+  getAllCommandNames,
+  replaceVariables
+};