jsharness 1.8.3 → 1.10.0

package/lib/index.mjs

@@ -3,6 +3,7 @@
  *
  * 多适配器架构：检测 AI 工具 → 转换规则格式 → 注入到对应位置
  *
+ * v1.10.0: 新增 5 个 OpenSpec Skills（openspec-explore/propose/apply/archive/skill-creator），Commands 精简为 Skill 委托模式
  * v1.8.0: 四桶分离架构（rules/skills/commands/agents），多源获取策略确保 100% 可用
  *   1. import.meta.url 定位本包 .harness/ （最快）
  *   2. process.argv[1] 反推包根目录（npx 直接执行时）
@@ -370,6 +371,7 @@ const SKILL_TRANSFORMERS = {
       if (lowerName.includes('build')) content += `trigger_type: manual\n`;
       else if (lowerName.includes('test')) content += `trigger_type: on_save\n`;
       else if (lowerName.includes('lint') || lowerName.includes('review')) content += `trigger_type: on_pr\n`;
+      else if (lowerName.includes('openspec')) content += `trigger_type: manual\n`;
       else content += `trigger_type: manual\n`;
       content += `---\n\n${body}`;
       outputs.push({ relativePath: `.claude/skills/${skillName}/SKILL.md`, content, source: file.path });
@@ -1750,6 +1752,17 @@ export async function runInit(projectDir, options = {}) {
     console.log(`  ⏭  跳过 ${openspecResult.skipped.length} 项 (已存在)`);
   }
 
+  // 7.5 初始化 Harness doc 目录（originRequirements + ttspec）
+  console.log('\n━━━ 初始化 Harness 文档目录 ━━━');
+  const harnessDocResult = initHarnessDoc(projectDir, { force, verbose });
+  if (harnessDocResult.created.length > 0) {
+    console.log(`  ✅ 创建 ${harnessDocResult.created.length} 项:`);
+    harnessDocResult.created.forEach(f => console.log(`     - ${f}`));
+  }
+  if (harnessDocResult.skipped.length > 0) {
+    console.log(`  ⏭  跳过 ${harnessDocResult.skipped.length} 项 (已存在)`);
+  }
+
   // 8. 输出总结
   console.log('\n═════════════════════════════');
   console.log('✅ 初始化完成！');
@@ -1873,6 +1886,15 @@ export function showStatus(projectDir) {
 
 const OPENSPEC_DIRS = ['openspec', 'openspec/changes', 'openspec/changes/archive', 'openspec/specs'];
 
+// Harness doc 子目录（需求入口 + ttspec 变更管理）
+const HARNESS_DOC_DIRS = [
+  '.harness/doc/originRequirements',
+  '.harness/doc/ttspec',
+  '.harness/doc/ttspec/change',
+  '.harness/doc/ttspec/change/archive',
+  '.harness/doc/ttspec/specs',
+];
+
 const OPENSPEC_GITIGNORE = `# OpenSpec generated files
 changes/*/dist/
 *.log
@@ -1919,6 +1941,130 @@ export function initOpenSpec(projectDir, options = {}) {
   return { created, skipped };
 }
 
+/**
+ * 初始化 .harness/doc/ 子目录（originRequirements + ttspec）
+ */
+export function initHarnessDoc(projectDir, options = {}) {
+  const { force = false, verbose = false } = options;
+  const created = [];
+  const skipped = [];
+
+  for (const dir of HARNESS_DOC_DIRS) {
+    const fullPath = path.join(projectDir, dir);
+    if (fs.existsSync(fullPath)) {
+      if (verbose) console.log(`  ⏭  目录已存在: ${dir}/`);
+      skipped.push(dir);
+      continue;
+    }
+    fs.mkdirSync(fullPath, { recursive: true });
+    created.push(dir);
+    if (verbose) console.log(`  ✅ 创建目录: ${dir}/`);
+  }
+
+  // 在空目录中添加 .gitkeep
+  for (const dir of HARNESS_DOC_DIRS) {
+    const gitkeepPath = path.join(projectDir, dir, '.gitkeep');
+    if (!fs.existsSync(gitkeepPath)) fs.writeFileSync(gitkeepPath, '', 'utf-8');
+  }
+
+  // originRequirements README
+  const originReadmePath = path.join(projectDir, '.harness/doc/originRequirements', 'README.md');
+  if (!fs.existsSync(originReadmePath) || force) {
+    fs.writeFileSync(originReadmePath, generateOriginRequirementsReadme(), 'utf-8');
+    created.push('.harness/doc/originRequirements/README.md');
+  } else {
+    skipped.push('.harness/doc/originRequirements/README.md');
+  }
+
+  // ttspec README
+  const ttspecReadmePath = path.join(projectDir, '.harness/doc/ttspec', 'README.md');
+  if (!fs.existsSync(ttspecReadmePath) || force) {
+    fs.writeFileSync(ttspecReadmePath, generateTtspecReadme(), 'utf-8');
+    created.push('.harness/doc/ttspec/README.md');
+  } else {
+    skipped.push('.harness/doc/ttspec/README.md');
+  }
+
+  return { created, skipped };
+}
+
+function generateOriginRequirementsReadme() {
+  return `# 原始需求文件目录
+
+本目录用于存放所有原始需求文件，是 Harness 需求分析的统一入口。
+
+## 文件命名规则
+
+格式：\`{YYYY-MM-DD}-{kebab-case-title}.md\`
+
+示例：
+- \`2026-05-22-user-avatar-upload.md\`
+- \`2026-06-15-order-export-feature.md\`
+
+## 最小内容要求
+
+每个需求文件至少包含以下两个章节：
+
+\`\`\`markdown
+# 需求标题
+
+## 背景
+
+描述需求的业务背景、当前痛点和动机。
+
+## 期望
+
+描述期望达到的效果或目标。
+\`\`\`
+
+## 工作流
+
+1. 用户在此目录下创建需求文件
+2. PM Agent 扫描发现新文件
+3. PM 在 \`.harness/doc/ttspec/change/\` 下创建对应 change
+4. 需求分析师按 explore → propose → prd 三步执行分析
+
+> 本目录由 Harness Engineering 系统管理。
+`;
+}
+
+function generateTtspecReadme() {
+  return `# ttspec — 变更规格管理目录
+
+本目录用于存放 Harness 流程中 OpenSpec 的产出物，包括变更管理（change）和能力规格（specs）。
+
+## 目录结构
+
+\`\`\`
+.harness/doc/ttspec/
+├── change/                    # 变更目录（每个需求对应一个子目录）
+│   ├── archive/               # 已归档的变更
+│   └── {change-name}/         # 活跃变更
+│       ├── explore-notes.md   # explore 阶段产出
+│       ├── proposal.md        # propose 阶段产出
+│       ├── design.md          # 设计决策
+│       ├── specs/             # 能力规格
+│       └── tasks.md           # 实施任务列表
+└── specs/                     # 全局能力规格
+    └── {capability}/
+        └── spec.md
+\`\`\`
+
+## 变更命名规则
+
+change 名称从原始需求文件名派生：去除日期前缀，保留 kebab-case 标题。
+
+示例：需求文件 \`2026-05-22-user-avatar-upload.md\` → change 名 \`user-avatar-upload\`
+
+## 与 openspec/ 的关系
+
+- \`openspec/\` — OpenSpec CLI 原生操作目录（历史数据保持不动）
+- \`.harness/doc/ttspec/\` — Harness 流程中的变更管理产出目录
+
+> 本目录由 Harness Engineering 系统管理。
+`;
+}
+
 function generateOpenSpecReadme() {
   return `# OpenSpec 变更管理
 
@@ -1937,10 +2083,11 @@ openspec/
 
 在 AI 对话中使用 OpenSpec skills：
 
-- **openspec-propose** — 创建新变更提案
-- **openspec-explore** — 探索和澄清需求
-- **openspec-apply-change** — 实施变更任务
-- **openspec-archive-change** — 归档已完成变更
+- **openspec-explore** — 需求深度探索
+- **openspec-propose** — 创建结构化提案
+- **openspec-apply** — 实施变更任务
+- **openspec-archive** — 归档已完成变更
+- **openspec-skill-creator** — 创建新的 Harness Skill
 
 ## 命令行操作
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsharness",
-  "version": "1.8.3",
+  "version": "1.10.0",
   "description": "Harness Engineering - AI 编程行为工程化管控系统。将 rules/skills/commands/agents 四桶一键注入到 CodeBuddy、Cursor、Copilot、Claude Code 等 AI 工具中。",
   "main": "lib/index.mjs",
   "bin": {