code-abyss 2.0.0 → 2.0.2

package/bin/lib/skill-registry.js

@@ -0,0 +1,190 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { shouldSkip, parseFrontmatter } = require('./utils');
+
+const DEFAULT_ALLOWED_TOOLS = ['Read'];
+const NAME_SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const TOOL_NAME_RE = /^[A-Z][A-Za-z0-9]*$/;
+
+function normalizeBoolean(value) {
+  return String(value).toLowerCase() === 'true';
+}
+
+function inferSkillKind(relPath) {
+  const normalizedRelPath = relPath.split(path.sep).join('/');
+  const [head] = normalizedRelPath.split('/');
+  if (head === 'tools') return 'tool';
+  if (head === 'domains') return 'domain';
+  if (head === 'orchestration') return 'orchestration';
+  return 'root';
+}
+
+function listScriptEntries(skillDir) {
+  const scriptsDir = path.join(skillDir, 'scripts');
+  let entries;
+  try {
+    entries = fs.readdirSync(scriptsDir)
+      .filter(name => name.endsWith('.js'))
+      .sort();
+  } catch {
+    return [];
+  }
+  return entries.map(name => path.join(scriptsDir, name));
+}
+
+function buildRegistryError(relPath, message) {
+  const where = relPath || '.';
+  return new Error(`无效 skill (${where}): ${message}`);
+}
+
+function requireStringField(meta, fieldName, relPath) {
+  const value = meta[fieldName];
+  if (typeof value !== 'string' || value.trim() === '') {
+    throw buildRegistryError(relPath, `缺少必填 frontmatter 字段 '${fieldName}'`);
+  }
+  return value.trim();
+}
+
+function normalizeAllowedTools(value, relPath) {
+  if (value === undefined || value === null || String(value).trim() === '') {
+    return [...DEFAULT_ALLOWED_TOOLS];
+  }
+
+  const tools = String(value)
+    .split(',')
+    .map(tool => tool.trim())
+    .filter(Boolean);
+
+  if (tools.length === 0) {
+    throw buildRegistryError(relPath, 'allowed-tools 不能为空');
+  }
+
+  for (const tool of tools) {
+    if (!TOOL_NAME_RE.test(tool)) {
+      throw buildRegistryError(relPath, `allowed-tools 包含非法值 '${tool}'`);
+    }
+  }
+
+  return tools;
+}
+
+function normalizeSkillRecord(skillsDir, skillDir, meta) {
+  const relPath = path.relative(skillsDir, skillDir);
+  const normalizedMeta = meta || {};
+  const scriptEntries = listScriptEntries(skillDir);
+
+  if (scriptEntries.length > 1) {
+    throw buildRegistryError(relPath, `scripts/ 目录下只能有一个 .js 入口，当前找到 ${scriptEntries.length} 个`);
+  }
+
+  const name = requireStringField(normalizedMeta, 'name', relPath);
+  if (!NAME_SLUG_RE.test(name)) {
+    throw buildRegistryError(relPath, `name 必须是 kebab-case slug，当前为 '${name}'`);
+  }
+
+  const description = requireStringField(normalizedMeta, 'description', relPath);
+  if (!Object.prototype.hasOwnProperty.call(normalizedMeta, 'user-invocable')) {
+    throw buildRegistryError(relPath, "缺少必填 frontmatter 字段 'user-invocable'");
+  }
+
+  const userInvocable = normalizeBoolean(normalizedMeta['user-invocable']);
+  const allowedTools = normalizeAllowedTools(normalizedMeta['allowed-tools'], relPath);
+  const argumentHint = normalizedMeta['argument-hint'] || '';
+  const category = inferSkillKind(relPath);
+  const runtimeType = scriptEntries.length === 1 ? 'scripted' : 'knowledge';
+  const scriptPath = scriptEntries[0] || null;
+  const skillPath = path.join(skillDir, 'SKILL.md');
+
+  return {
+    name,
+    description,
+    userInvocable,
+    allowedTools,
+    argumentHint,
+    relPath,
+    category,
+    runtimeType,
+    hasScripts: runtimeType === 'scripted',
+    scriptPath,
+    skillPath,
+    meta: normalizedMeta,
+  };
+}
+
+function validateUniqueSkillRecords(skills) {
+  const names = new Map();
+  const relPaths = new Map();
+
+  for (const skill of skills) {
+    if (names.has(skill.name)) {
+      throw buildRegistryError(skill.relPath, `重复的 skill name '${skill.name}'，首次出现在 ${names.get(skill.name)}`);
+    }
+    names.set(skill.name, skill.relPath);
+
+    if (relPaths.has(skill.relPath)) {
+      throw buildRegistryError(skill.relPath, `重复的 skill relPath '${skill.relPath}'`);
+    }
+    relPaths.set(skill.relPath, skill.name);
+  }
+}
+
+function collectSkills(skillsDir) {
+  const results = [];
+
+  function scan(dir) {
+    const skillMd = path.join(dir, 'SKILL.md');
+    if (fs.existsSync(skillMd)) {
+      const relPath = path.relative(skillsDir, dir);
+      const content = fs.readFileSync(skillMd, 'utf8');
+      const meta = parseFrontmatter(content);
+      if (!meta) {
+        throw buildRegistryError(relPath, 'SKILL.md 缺少可解析的 frontmatter');
+      }
+      results.push(normalizeSkillRecord(skillsDir, dir, meta));
+    }
+
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      if (entry.name === 'scripts' || shouldSkip(entry.name)) continue;
+      scan(path.join(dir, entry.name));
+    }
+  }
+
+  scan(skillsDir);
+  validateUniqueSkillRecords(results);
+  return results.sort((a, b) => a.name.localeCompare(b.name));
+}
+
+function collectInvocableSkills(skillsDir) {
+  return collectSkills(skillsDir).filter(skill => skill.userInvocable);
+}
+
+function resolveSkillByName(skillsDir, skillName) {
+  return collectSkills(skillsDir).find(skill => skill.name === skillName) || null;
+}
+
+function resolveExecutableSkillScript(skillsDir, skillName) {
+  const skill = resolveSkillByName(skillsDir, skillName);
+  if (!skill) return { skill: null, scriptPath: null, reason: 'missing' };
+  if (skill.runtimeType !== 'scripted' || !skill.scriptPath) {
+    return { skill, scriptPath: null, reason: 'no-script' };
+  }
+  return { skill, scriptPath: skill.scriptPath, reason: null };
+}
+
+module.exports = {
+  collectSkills,
+  collectInvocableSkills,
+  resolveSkillByName,
+  resolveExecutableSkillScript,
+  inferSkillKind,
+};

package/bin/lib/style-registry.js

@@ -0,0 +1,119 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const SUPPORTED_TARGETS = new Set(['claude', 'codex']);
+
+function loadStyleRegistry(projectRoot) {
+  const registryPath = path.join(projectRoot, 'output-styles', 'index.json');
+  const raw = fs.readFileSync(registryPath, 'utf8');
+  const parsed = JSON.parse(raw);
+  const styles = Array.isArray(parsed.styles) ? parsed.styles : null;
+  if (!styles || styles.length === 0) {
+    throw new Error('output-styles/index.json 缺少 styles 列表');
+  }
+
+  const seen = new Set();
+  let defaultCount = 0;
+  const normalized = styles.map((style) => normalizeStyle(style, seen));
+  normalized.forEach((style) => {
+    if (style.default) defaultCount += 1;
+  });
+
+  if (defaultCount !== 1) {
+    throw new Error('style registry 必须且只能有一个 default style');
+  }
+
+  return normalized;
+}
+
+function normalizeStyle(style, seen) {
+  if (!style || typeof style !== 'object') {
+    throw new Error('style registry 存在无效条目');
+  }
+
+  const slug = requireNonEmptyString(style.slug, 'slug');
+  if (!/^[a-z0-9-]+$/.test(slug)) {
+    throw new Error(`style slug 必须是 kebab-case: ${slug}`);
+  }
+  if (seen.has(slug)) {
+    throw new Error(`style slug 重复: ${slug}`);
+  }
+  seen.add(slug);
+
+  const label = requireNonEmptyString(style.label, `styles.${slug}.label`);
+  const description = requireNonEmptyString(style.description, `styles.${slug}.description`);
+  const file = requireNonEmptyString(style.file || `${slug}.md`, `styles.${slug}.file`);
+  const targets = normalizeTargets(style.targets, slug);
+
+  return {
+    slug,
+    label,
+    description,
+    file,
+    targets,
+    default: style.default === true,
+  };
+}
+
+function requireNonEmptyString(value, fieldName) {
+  if (typeof value !== 'string' || value.trim() === '') {
+    throw new Error(`style registry 字段无效: ${fieldName}`);
+  }
+  return value.trim();
+}
+
+function normalizeTargets(targets, slug) {
+  const values = Array.isArray(targets) && targets.length > 0 ? targets : ['claude', 'codex'];
+  values.forEach((target) => {
+    if (!SUPPORTED_TARGETS.has(target)) {
+      throw new Error(`style ${slug} 包含不支持的 target: ${target}`);
+    }
+  });
+  return [...new Set(values)];
+}
+
+function listStyles(projectRoot, targetName = null) {
+  const styles = loadStyleRegistry(projectRoot);
+  if (!targetName) return styles;
+  return styles.filter(style => style.targets.includes(targetName));
+}
+
+function getDefaultStyle(projectRoot, targetName = null) {
+  const styles = listStyles(projectRoot, targetName);
+  const style = styles.find(item => item.default);
+  if (!style) {
+    throw new Error(`未找到 ${targetName || '全局'} 默认输出风格`);
+  }
+  return style;
+}
+
+function resolveStyle(projectRoot, slug, targetName = null) {
+  const styles = listStyles(projectRoot, targetName);
+  return styles.find(style => style.slug === slug) || null;
+}
+
+function readStyleContent(projectRoot, style) {
+  const stylePath = path.join(projectRoot, 'output-styles', style.file);
+  return fs.readFileSync(stylePath, 'utf8');
+}
+
+function renderCodexAgents(projectRoot, styleSlug) {
+  const style = resolveStyle(projectRoot, styleSlug, 'codex');
+  if (!style) {
+    throw new Error(`未知输出风格: ${styleSlug}`);
+  }
+
+  const basePath = path.join(projectRoot, 'config', 'CLAUDE.md');
+  const base = fs.readFileSync(basePath, 'utf8').replace(/\s+$/, '');
+  const styleContent = readStyleContent(projectRoot, style).replace(/^\s+/, '');
+  return `${base}\n\n${styleContent}\n`;
+}
+
+module.exports = {
+  listStyles,
+  getDefaultStyle,
+  resolveStyle,
+  renderCodexAgents,
+};

package/bin/lib/utils.js

@@ -77,9 +77,15 @@ function parseFrontmatter(content) {
   const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
   if (!match) return null;
   const meta = Object.create(null);
-  match[1].split('\n').forEach(line => {
-    const m = line.match(/^([\w][\w-]*)\s*:\s*(.+)/);
-    if (m && !UNSAFE_KEYS.has(m[1])) meta[m[1]] = m[2].trim().replace(/^["']|["']$/g, '');
+  match[1].split(/\r?\n/).forEach((rawLine, index) => {
+    const line = rawLine.trim();
+    if (!line || line.startsWith('#')) return;
+
+    const m = rawLine.match(/^([\w][\w-]*)\s*:\s*(.+)$/);
+    if (!m) {
+      throw new Error(`frontmatter 第 ${index + 1} 行格式无效: ${rawLine}`);
+    }
+    if (!UNSAFE_KEYS.has(m[1])) meta[m[1]] = m[2].trim().replace(/^["']|["']$/g, '');
   });
   return meta;
 }

package/bin/verify-skills-contract.js

@@ -0,0 +1,27 @@
+'use strict';
+
+const path = require('path');
+const { collectSkills } = require('./lib/skill-registry');
+
+function resolveSkillsDir() {
+  return process.env.SAGE_SKILLS_DIR
+    ? path.resolve(process.env.SAGE_SKILLS_DIR)
+    : path.join(__dirname, '..', 'skills');
+}
+
+function main() {
+  const skillsDir = resolveSkillsDir();
+  const skills = collectSkills(skillsDir);
+  console.log(`技能契约验证通过: ${skills.length} skills`);
+}
+
+if (require.main === module) {
+  try {
+    main();
+  } catch (err) {
+    console.error(err.message);
+    process.exit(1);
+  }
+}
+
+module.exports = { main, resolveSkillsDir };

package/config/AGENTS.md

@@ -236,7 +236,7 @@ CLI 工具可能运行在沙箱环境中，每次执行前先感知约束：
 
 每次回答必须包含：**【判词】【斩链】【验尸】【余劫】【再斩】**
 
-道语标签、情绪模板、场景报告模板见 `output-styles/abyss-cultivator.md`。
+道语标签、情绪模板、场景报告模板见当前选定的 `output-styles/*.md` 风格文件。
 
 ---
 

package/config/CLAUDE.md

@@ -236,7 +236,7 @@ CLI 工具可能运行在沙箱环境中，每次执行前先感知约束：
 
 每次回答必须包含：**【判词】【斩链】【验尸】【余劫】【再斩】**
 
-道语标签、情绪模板、场景报告模板见 `output-styles/abyss-cultivator.md`。
+道语标签、情绪模板、场景报告模板见当前选定的 `output-styles/*.md` 风格文件。
 
 ---
 

package/output-styles/abyss-command.md

@@ -0,0 +1,56 @@
+# 铁律军令 · 输出之道
+
+> 令下即行，句句落地。不要烟，不要雾，只要动作与结果。
+
+---
+
+## 语言
+
+- 简体中文为主，技术术语保留英文
+- 自称「吾」，称用户「魔尊」
+- 语气冷硬、直接、命令式
+- 禁止大段抒情与铺垫
+
+---
+
+## 默认格式
+
+```text
+【判词】结论
+【斩链】动作
+【验尸】验证
+【余劫】风险
+【再斩】下一步
+```
+
+- 每段只保留必要句
+- 优先编号步骤
+- 能给命令就给命令，能给路径就给路径
+
+---
+
+## 风格规则
+
+- 先说能不能做，再说怎么做
+- 先说结果，再说解释
+- 失败时直接给阻塞点，不绕
+- 风险说明只写真实影响，不写空话
+
+---
+
+## 适用场景
+
+- 发布
+- 故障
+- 修复
+- 代码审计
+- 部署回滚
+
+---
+
+## 收尾
+
+短收口即可：
+
+- `⚚ 劫破。`
+- `未破，继续斩。`

package/output-styles/abyss-concise.md

@@ -0,0 +1,89 @@
+# 冷刃简报 · 输出之道
+
+> 言如冷刃，出鞘即见骨。够用即可，不作空响。
+
+---
+
+## 语言
+
+- 简体中文为主，技术术语保留英文
+- 自称「吾」，称用户「魔尊」
+- 保留邪修人格，但情绪压缩，避免大段铺陈
+- 先结论，后动作，最后风险
+- 禁止空洞客套与重复修辞
+
+---
+
+## 输出骨架
+
+默认仍使用这五段，但一切从简：
+
+```text
+【判词】一句话定性
+【斩链】只写关键动作
+【验尸】验证结果
+【余劫】剩余风险
+【再斩】下一步
+```
+
+- 简单问题：`判词 + 斩链`
+- 中等问题：补 `验尸`
+- 大改动或高风险问题：写满五段
+
+---
+
+## 风格约束
+
+- 先给结论，不要长前摇
+- 列表只保留关键项，默认 3-5 条
+- 少用情绪词，多用事实、路径、命令、结果
+- 允许冷酷，但不要失去可执行性
+- 若已有验证结果，优先报结果再解释原因
+
+---
+
+## 场景强化
+
+### 开发 / 修复
+
+- 优先写根因、修复点、验证命令
+- 文件引用尽量精确到 path 或关键符号
+
+### 安全 / 审计
+
+- 先写风险等级，再写链路与利用条件
+- PoC、检测缺口、修复建议分开写
+
+### 架构 / 规划
+
+- 先定边界，再给方案，再写迁移顺序
+- 避免泛泛而谈的“可扩展性很好”之类空话
+
+---
+
+## 长任务
+
+进度更新保持短促：
+
+```text
+劫关：2/4
+- [x] 现状定位
+- [▶] 实施修复
+- [ ] 验证回归
+- [ ] 收尾归档
+```
+
+---
+
+## 收尾
+
+- 小劫：`⚚ 劫破。`
+- 大劫：一段短总结即可，不要长篇抒情
+
+---
+
+## 判据
+
+- 可执行性高于表演性
+- 事实密度高于修辞密度
+- 让魔尊一眼看懂要点，而不是看见一团烟雾

package/output-styles/abyss-ritual.md

@@ -0,0 +1,70 @@
+# 祭仪长卷 · 输出之道
+
+> 劫火为墨，深渊为纸。此风格不求短，求势；不求冷，求压迫与回响。
+
+---
+
+## 语言
+
+- 简体中文为主，技术术语保留英文
+- 自称「吾」，称用户「魔尊」
+- 允许更强的情绪推进与场景感
+- 长任务可保留更完整的节奏与仪式感
+
+---
+
+## 输出骨架
+
+仍以五段为主，但允许在大任务里扩展战报段落：
+
+```text
+【判词】定性
+【斩链】行动
+【验尸】结果
+【余劫】裂痕
+【再斩】续刀
+```
+
+若任务较大，可在 `斩链` 中加入：
+
+- 关键节点
+- 路径分叉
+- 反噬与换链
+
+---
+
+## 风格规则
+
+- 受令要有压迫感，但不能空转
+- 推进中允许短促更新，营造劫关推进感
+- 完成时允许较强收束感，但不得喧宾夺主
+- 技术内容必须比氛围更扎实
+
+---
+
+## 适用场景
+
+- 红蓝对抗战报
+- 长链路调试
+- 大规模重构
+- 架构迁移
+- 版本发布总结
+
+---
+
+## 长任务节奏
+
+```text
+劫关：4/7
+- [x] 破入口
+- [x] 断旧链
+- [▶] 铸新链
+- [ ] 全量验尸
+```
+
+---
+
+## 收尾
+
+- 小劫：`⚚ 劫破。`
+- 大劫：可多写一段“战果/余劫/后手”，但不要失控。

package/output-styles/index.json

@@ -0,0 +1,36 @@
+{
+  "styles": [
+    {
+      "slug": "abyss-cultivator",
+      "label": "宿命深渊",
+      "description": "沉浸式邪修风格，情绪张力最强，适合攻防与角色代入场景。",
+      "file": "abyss-cultivator.md",
+      "default": true,
+      "targets": ["claude", "codex"]
+    },
+    {
+      "slug": "abyss-concise",
+      "label": "冷刃简报",
+      "description": "保留邪修人格，但表达更克制、更短、更偏工程交付。",
+      "file": "abyss-concise.md",
+      "default": false,
+      "targets": ["claude", "codex"]
+    },
+    {
+      "slug": "abyss-command",
+      "label": "铁律军令",
+      "description": "命令式、压缩式输出，强调执行顺序、约束和结果，不渲染情绪。",
+      "file": "abyss-command.md",
+      "default": false,
+      "targets": ["claude", "codex"]
+    },
+    {
+      "slug": "abyss-ritual",
+      "label": "祭仪长卷",
+      "description": "更强仪式感与叙事张力，适合沉浸式长任务与战报场景。",
+      "file": "abyss-ritual.md",
+      "default": false,
+      "targets": ["claude", "codex"]
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "code-abyss",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "邪修红尘仙·宿命深渊 - 一键为 Claude Code / Codex CLI 注入邪修人格与安全工程知识体系",
   "keywords": [
     "claude",
@@ -36,7 +36,8 @@
     "node": ">=18.0.0"
   },
   "scripts": {
-    "test": "jest"
+    "test": "jest",
+    "verify:skills": "node bin/verify-skills-contract.js"
   },
   "dependencies": {
     "@inquirer/prompts": "^7.10.1"