jsharness 1.11.0 → 1.12.2

package/.harness/skills/jsspec-deliver/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: jsspec-deliver
+description: 交付归档技能 — 合并 apply + archive 为单一 workflow 控制的两阶段流程（Phase 1 实施 + Phase 2 归档），含门禁确认、原始需求归档到 origin-main、PRD 归档到 prd-main/{module}
+alwaysApply: false
+enabled: true
+outputPath: .harness/doc/ttspec/change/
+---
+
+# 交付归档技能 (jsspec-deliver)
+
+> **Skill 类型**: 项目管理辅助 Skill
+> **触发场景**: propose 产出完成且用户确认设计后，执行实施和归档的统一流程
+> **所属 Agent**: developer / project-manager
+> **输出路径**: `.harness/doc/ttspec/change/{name}/` + `.harness/doc/originRequirements/origin-main/` + `.harness/doc/prd/prd-main/{module}/`
+
+---
+
+## 1. 核心职责
+
+作为交付归档技能，核心职责是：
+
+1. **两阶段工作流控制**：实施任务 → 用户确认 → 归档
+2. **统一归档操作**：change 目录归档 + 原始需求归档 + PRD 归档
+
+### 1.1 前置条件
+
+- propose 产出已完成（proposal.md、design.md、specs/、tasks.md）
+- 用户已确认设计方案
+- PRD 已生成（如适用）
+
+### 1.2 输入
+
+|| 输入项 | 路径 | 格式 | 必须 |
+||--------|------|------|------|
+|| 任务列表 | `.harness/doc/ttspec/change/{name}/tasks.md` | Markdown | 是 |
+|| 提案文档 | `.harness/doc/ttspec/change/{name}/proposal.md` | Markdown | 是 |
+|| 设计文档 | `.harness/doc/ttspec/change/{name}/design.md` | Markdown | 是 |
+|| 能力规格 | `.harness/doc/ttspec/change/{name}/specs/` | Markdown | 是 |
+|| PRD 文档 | `.harness/doc/prd/requirements-{name}.md` | Markdown | 否 |
+
+### 1.3 输出
+
+|| 输出项 | 路径 | 格式 | 必须 |
+||--------|------|------|------|
+|| 归档目录 | `.harness/doc/ttspec/change/archive/{YYYY-MM-DD}-{name}/` | 目录 | 是 |
+|| 原始需求归档 | `.harness/doc/originRequirements/origin-main/{filename}` | Markdown | 是 |
+|| PRD 归档 | `.harness/doc/prd/prd-main/{module}/requirements-{name}.md` | Markdown | 否 |
+|| PRD 索引更新 | `.harness/doc/prd/prd-main/README.md` | Markdown | 否 |
+
+---
+
+## 2. 两阶段工作流
+
+### Phase 1: 实施任务
+
+#### Step 1: 读取任务列表
+
+从 `.harness/doc/ttspec/change/{name}/tasks.md` 读取任务列表，识别所有待完成任务（标记为 `- [ ]`）。
+
+#### Step 2: 逐任务实施
+
+对每个待完成任务：
+
+1. 读取任务描述和涉及的文件路径
+2. 读取相关的 specs、design 和 PRD 文档获取上下文
+3. 实施代码/文档变更
+4. **立即**将任务标记为已完成：将 `- [ ]` 改为 `- [x]`
+5. 继续下一个任务
+
+#### Step 3: 暂停条件
+
+以下情况**必须暂停**：
+
+|| 暂停条件 | 处理方式 |
+||---------|---------|
+|| 任务描述不清晰 | 暂停并询问用户澄清 |
+|| 实施中发现设计问题 | 暂停并建议更新 design/specs |
+|| 遇到错误或阻塞 | 暂停并报告，等待指导 |
+|| 用户中断 | 保存当前进度并停止 |
+
+#### Step 4: Phase 1 完成门禁
+
+所有任务完成后，**必须**向用户确认：
+
+> "所有任务已完成，是否进入归档阶段？"
+
+- 用户确认 → 进入 Phase 2
+- 用户不满意 → 继续修改或补充，完成后再次确认
+- **禁止**自动进入 Phase 2
+
+---
+
+### Phase 2: 归档
+
+#### Step 1: 归档 change 目录
+
+将 `.harness/doc/ttspec/change/{name}/` 整个目录移动到 `.harness/doc/ttspec/change/archive/{YYYY-MM-DD}-{name}/`。
+
+#### Step 2: 归档原始需求文件
+
+1. 查找 `.harness/doc/originRequirements/` 中与本次 change 关联的原始需求文件
+2. 将该文件**移动**到 `.harness/doc/originRequirements/origin-main/`，保持原文件名
+3. 如果找不到原始需求文件，记录 "未找到原始需求文件，跳过需求归档"
+
+#### Step 3: 归档 PRD 文件
+
+1. 查找 `.harness/doc/prd/requirements-{name}.md`
+2. 如果 PRD 存在：
+   - 读取 PRD 文件，提取 "涉及产品线/模块" 字段
+   - 如果有模块信息 → 移动到 `.harness/doc/prd/prd-main/{module}/requirements-{name}.md`
+   - 如果没有模块信息 → 移动到 `.harness/doc/prd/prd-main/general/requirements-{name}.md`
+   - 更新 `.harness/doc/prd/prd-main/README.md` 索引
+3. 如果 PRD 不存在，记录 "无 PRD 文件，跳过 PRD 归档"
+
+#### Step 4: 输出归档摘要
+
+```
+✅ 变更 "{name}" 已归档
+   归档位置：.harness/doc/ttspec/change/archive/{date}-{name}/
+   原始需求：.harness/doc/originRequirements/origin-main/{filename}
+   PRD 归档：.harness/doc/prd/prd-main/{module}/requirements-{name}.md
+```
+
+---
+
+## 3. 约束
+
+- **保持变更最小化** — 每个任务只做必要修改，不做额外重构
+- **立即标记完成** — 完成任务后立即更新 tasks.md 中的复选框
+- **遇到阻塞暂停** — 不猜测、不绕过，暂停并报告
+- **Phase 2 必须经过用户确认** — Phase 1 完成后禁止自动进入归档
+- **归档是移动操作** — 原始需求和 PRD 文件从原位置移除，归档到新位置
+- **日期格式** — 归档目录名使用 `{YYYY-MM-DD}-{name}` 格式
+- **所有输出使用中文**

package/.harness/skills/{openspec-explore → jsspec-explore}/SKILL.md

@@ -1,12 +1,12 @@
 ---
-name: openspec-explore
+name: jsspec-explore
 description: 需求深度探索技能 — 四维度探索框架（范围边界/受影响角色/假设前提/风险面）、探索笔记模板、完成判定标准，产出存放于 .harness/doc/ttspec/change/{name}/explore-notes.md
 alwaysApply: false
 enabled: true
 outputPath: .harness/doc/ttspec/change/
 ---
 
-# 需求深度探索技能 (openspec-explore)
+# 需求深度探索技能 (jsspec-explore)
 
 > **Skill 类型**: 需求分析辅助 Skill
 > **触发场景**: 收到新需求后、生成任何文档之前，进行需求深度探索
@@ -30,17 +30,17 @@ outputPath: .harness/doc/ttspec/change/
 
 ### 1.2 输入
 
-| 输入项 | 路径 | 格式 | 必须 |
-|--------|------|------|------|
-| 原始需求文件 | `.harness/doc/originRequirements/{filename}` | Markdown | 是 |
-| ttspec change 目录 | `.harness/doc/ttspec/change/{name}/` | 目录 | 是 |
-| dev-map 参考文档 | `.harness/dev-map/` | Markdown | 否 |
+|| 输入项 | 路径 | 格式 | 必须 |
+||--------|------|------|------|
+|| 原始需求文件 | `.harness/doc/originRequirements/{filename}` | Markdown | 是 |
+|| ttspec change 目录 | `.harness/doc/ttspec/change/{name}/` | 目录 | 是 |
+|| dev-map 参考文档 | `.harness/dev-map/` | Markdown | 否 |
 
 ### 1.3 输出
 
-| 输出项 | 路径 | 格式 | 必须 |
-|--------|------|------|------|
-| 探索笔记 | `.harness/doc/ttspec/change/{name}/explore-notes.md` | Markdown | 是 |
+|| 输出项 | 路径 | 格式 | 必须 |
+||--------|------|------|------|
+|| 探索笔记 | `.harness/doc/ttspec/change/{name}/explore-notes.md` | Markdown | 是 |
 
 ---
 
@@ -105,9 +105,18 @@ outputPath: .harness/doc/ttspec/change/
 
 ## 4. 执行步骤
 
-### Step 1: 读取原始需求
+### Step 1: 解析输入源
 
-从 `.harness/doc/originRequirements/` 中读取对应的原始需求文件。
+> **前置步骤**：如果本次探索是在已有需求基础上进行（如迭代设计），必须先执行 `design-context-reader` Skill 读取已有 PRD 和 ttspec change 内容作为参考上下文。
+
+按以下优先级确定需求文件来源：
+
+1. **扫描 originRequirements/**：列出 `.harness/doc/originRequirements/` 下所有 `.md` 文件（排除 `README.md`、`.gitkeep` 和 `origin-main/` 子目录）
+   - 如果只有 1 个文件 → 自动选择并告知用户
+   - 如果有多个文件 → 列出编号列表让用户选择
+   - 如果没有文件 → 进入步骤 2
+2. **用户指定路径**：如果用户在命令中提供了文件路径，验证文件存在后使用
+3. **提示用户**：如果以上都没有，提示用户 "未找到需求文件。请在 .harness/doc/originRequirements/ 下创建需求文件，或提供需求文件路径"，并**禁止继续执行**
 
 ### Step 2: 进入探索模式
 
@@ -122,7 +131,17 @@ outputPath: .harness/doc/ttspec/change/
 - 用户明确确认探索内容满意，或
 - 探索轮次达到上限（maxTurns: 10）且用户同意推进
 
-完成后进入 propose 步骤（调用 `openspec-propose` Skill）。
+### Step 5: 用户确认门禁（强制）
+
+**⚠️ 本步骤为强制门禁，禁止跳过或自动推进**
+
+探索笔记生成后，**必须**向用户展示摘要并明确询问：
+
+> "是否确认探索结果？确认后进入提案阶段（propose）。如需补充或修改，请告知。"
+
+- 用户确认 → 进入 propose 阶段（调用 `jsspec-propose` Skill）
+- 用户不满意 → 回到 Step 2 继续探索，更新 explore-notes.md，然后再次回到本步骤确认
+- **禁止**在未经用户确认的情况下自动调用 `jsspec-propose`
 
 ---
 
@@ -132,4 +151,7 @@ outputPath: .harness/doc/ttspec/change/
 - **禁止编造** — 信息不足则追问，不编造假设
 - **四个维度必须全覆盖** — 缺少任何一个维度的探索都视为未完成
 - **轮次上限** — 最多 10 轮讨论，达到上限时总结当前发现并询问是否推进
+- **禁止自动推进到 propose** — explore 完成后必须等待用户确认（Step 5 门禁），未经确认禁止调用 jsspec-propose
+- **输入源优先级** — 必须按 Step 1 顺序查找需求文件：originRequirements/ → 用户路径 → 提示创建
+- **origin-main 排除** — 扫描 originRequirements/ 时排除 origin-main/ 子目录中的文件
 - **所有输出使用中文**

package/.harness/skills/{openspec-propose → jsspec-propose}/SKILL.md

@@ -1,12 +1,12 @@
 ---
-name: openspec-propose
+name: jsspec-propose
 description: 结构化提案技能 — 从探索笔记生成 proposal/design/specs/tasks 的完整流程、产出物规范、与 PRD 的衔接，产出存放于 .harness/doc/ttspec/change/{name}/
 alwaysApply: false
 enabled: true
 outputPath: .harness/doc/ttspec/change/
 ---
 
-# 结构化提案技能 (openspec-propose)
+# 结构化提案技能 (jsspec-propose)
 
 > **Skill 类型**: 需求分析辅助 Skill
 > **触发场景**: explore 探索完成后，生成结构化提案
@@ -20,7 +20,7 @@ outputPath: .harness/doc/ttspec/change/
 作为结构化提案技能，核心职责是：
 
 1. **基于探索笔记生成结构化提案**
-2. **衔接 PRD 生成**
+2. **等待用户确认设计后才生成 PRD**
 
 ### 1.1 前置条件
 
@@ -29,20 +29,20 @@ outputPath: .harness/doc/ttspec/change/
 
 ### 1.2 输入
 
-| 输入项 | 路径 | 格式 | 必须 |
-|--------|------|------|------|
-| 探索笔记 | `.harness/doc/ttspec/change/{name}/explore-notes.md` | Markdown | 是 |
-| 原始需求文件 | `.harness/doc/originRequirements/{filename}` | Markdown | 否（已含在探索笔记中） |
-| dev-map 参考文档 | `.harness/dev-map/` | Markdown | 否 |
+|| 输入项 | 路径 | 格式 | 必须 |
+||--------|------|------|------|
+|| 探索笔记 | `.harness/doc/ttspec/change/{name}/explore-notes.md` | Markdown | 是 |
+|| 原始需求文件 | `.harness/doc/originRequirements/{filename}` | Markdown | 否（已含在探索笔记中） |
+|| dev-map 参考文档 | `.harness/dev-map/` | Markdown | 否 |
 
 ### 1.3 输出
 
-| 输出项 | 路径 | 格式 | 必须 |
-|--------|------|------|------|
-| 提案文档 | `.harness/doc/ttspec/change/{name}/proposal.md` | Markdown | 是 |
-| 设计文档 | `.harness/doc/ttspec/change/{name}/design.md` | Markdown | 是 |
-| 能力规格 | `.harness/doc/ttspec/change/{name}/specs/{capability}/spec.md` | Markdown | 是 |
-| 任务列表 | `.harness/doc/ttspec/change/{name}/tasks.md` | Markdown | 是 |
+|| 输出项 | 路径 | 格式 | 必须 |
+||--------|------|------|------|
+|| 提案文档 | `.harness/doc/ttspec/change/{name}/proposal.md` | Markdown | 是 |
+|| 设计文档 | `.harness/doc/ttspec/change/{name}/design.md` | Markdown | 是 |
+|| 能力规格 | `.harness/doc/ttspec/change/{name}/specs/{capability}/spec.md` | Markdown | 是 |
+|| 任务列表 | `.harness/doc/ttspec/change/{name}/tasks.md` | Markdown | 是 |
 
 ---
 
@@ -145,6 +145,8 @@ outputPath: .harness/doc/ttspec/change/
 
 ### Step 1: 读取探索笔记
 
+> **前置步骤**：如果本次 propose 是在已有需求基础上迭代，必须先执行 `design-context-reader` Skill 读取已有 PRD 和 ttspec change 内容，确保设计决策与现有上下文一致。
+
 从 `.harness/doc/ttspec/change/{name}/explore-notes.md` 读取探索结果。
 
 ### Step 2: 生成 proposal.md
@@ -163,9 +165,21 @@ outputPath: .harness/doc/ttspec/change/
 
 生成实施任务列表。
 
-### Step 6: 衔接 PRD
+### Step 6: 用户确认门禁（强制）
+
+**⚠️ 本步骤为强制门禁，禁止跳过或自动推进**
+
+所有 propose 产出（proposal.md、design.md、specs/、tasks.md）生成后，**必须**向用户展示摘要并明确询问：
+
+> "是否确认设计方案？确认后生成 PRD。如需修改，请告知调整内容。"
+
+- 用户确认 → 调用 `prd-generator` Skill 生成 PRD
+- 用户不满意 → 更新相关 propose 产出后，再次回到本步骤确认
+- **禁止**在未经用户确认的情况下自动调用 `prd-generator`
+
+### Step 7: 生成 PRD（用户确认后）
 
-所有 propose 产出完成后，调用 `prd-generator` 技能，以探索笔记和 propose 产出作为输入上下文，在 `.harness/doc/prd/requirements-{task-id}.md` 生成标准化 PRD。
+用户确认设计方案后，调用 `prd-generator` 技能，以探索笔记和 propose 产出作为输入上下文，在 `.harness/doc/prd/requirements-{name}.md` 生成标准化 PRD。
 
 ---
 
@@ -175,4 +189,5 @@ outputPath: .harness/doc/ttspec/change/
 - **proposal 必须引用来源** — 包含 `来源: .harness/doc/originRequirements/{filename}`
 - **specs 必须使用 WHEN/THEN 格式** — 确保可测试
 - **tasks 必须使用复选框格式** — 确保 apply 阶段可追踪
+- **禁止自动生成 PRD** — propose 完成后必须等待用户确认（Step 6 门禁），未经确认禁止调用 prd-generator
 - **所有输出使用中文**

package/.harness/skills/{openspec-skill-creator → jsspec-skill-creator}/SKILL.md

@@ -1,12 +1,12 @@
 ---
-name: openspec-skill-creator
+name: jsspec-skill-creator
 description: Skill 创建辅助技能 — 在 Harness 体系内创建新 Skill 的模板和流程，包含命名校验、Agent 关联和标准 SKILL.md 模板
 alwaysApply: false
 enabled: true
 outputPath: .harness/skills/
 ---
 
-# Skill 创建辅助技能 (openspec-skill-creator)
+# Skill 创建辅助技能 (jsspec-skill-creator)
 
 > **Skill 类型**: 工程基础设施 Skill
 > **触发场景**: 需要在 Harness 体系内创建新的 Skill
@@ -24,18 +24,18 @@ outputPath: .harness/skills/
 
 ### 1.1 输入
 
-| 输入项 | 说明 | 必须 |
-|--------|------|------|
-| Skill 名称 | kebab-case 格式（如 `user-profile-export`） | 是 |
-| Skill 描述 | 中文简要描述 | 是 |
-| 所属 Agent | 可调用此 Skill 的 Agent 角色 | 是 |
-| 输出路径 | Skill 产出的目标目录 | 否（有默认值） |
+|| 输入项 | 说明 | 必须 |
+||--------|------|------|
+|| Skill 名称 | kebab-case 格式（如 `user-profile-export`） | 是 |
+|| Skill 描述 | 中文简要描述 | 是 |
+|| 所属 Agent | 可调用此 Skill 的 Agent 角色 | 是 |
+|| 输出路径 | Skill 产出的目标目录 | 否（有默认值） |
 
 ### 1.2 输出
 
-| 输出项 | 路径 | 格式 |
-|--------|------|------|
-| SKILL.md 文件 | `.harness/skills/{skill-name}/SKILL.md` | Markdown |
+|| 输出项 | 路径 | 格式 |
+||--------|------|------|
+|| SKILL.md 文件 | `.harness/skills/{skill-name}/SKILL.md` | Markdown |
 
 ---
 
@@ -91,15 +91,15 @@ outputPath: {输出路径}
 
 ### 1.1 输入
 
-| 输入项 | 路径/说明 | 格式 | 必须 |
-|--------|----------|------|------|
-| {输入1} | {路径} | {格式} | 是 |
+|| 输入项 | 路径/说明 | 格式 | 必须 |
+||--------|----------|------|------|
+|| {输入1} | {路径} | {格式} | 是 |
 
 ### 1.2 输出
 
-| 输出项 | 路径/说明 | 格式 | 必须 |
-|--------|----------|------|------|
-| {输出1} | {路径} | {格式} | 是 |
+|| 输出项 | 路径/说明 | 格式 | 必须 |
+||--------|----------|------|------|
+|| {输出1} | {路径} | {格式} | 是 |
 
 ---
 

package/.harness/workflow/definition.yaml

@@ -77,14 +77,14 @@ workflow:
           description: "深度探索需求 — 范围边界、受影响角色、假设与前提、风险面"
           input: "原始需求文件"
           output: ".harness/doc/ttspec/change/{name}/explore-notes.md"
-          command: "explore"
+          skill: "jsspec-explore"
           max_turns: 10
         - step: 2
           name: "propose"
           description: "生成结构化提案 — proposal/design/specs/tasks"
           input: "explore-notes.md"
           output: ".harness/doc/ttspec/change/{name}/ (proposal.md, design.md, specs/, tasks.md)"
-          command: "propose"
+          skill: "jsspec-propose"
         - step: 3
           name: "prd-generation"
           description: "使用 prd-generator 技能生成标准化 PRD"
@@ -521,8 +521,8 @@ workflow:
     - id: delivery
       name: "交付归档"
       order: 7
-      agent: project-manager
-      model_tier: lite
+      agent: developer / project-manager
+      model_tier: standard / lite
       max_turns: 5
       
       inputs:

package/.harness/workflow/validate.js

@@ -296,7 +296,7 @@ class WorkflowValidator {
     // 写入校验结果文件
     const outputPath = path.join(HARNESS_ROOT, '..', '..', '.workflow-validation-result.json');
     try {
-      // 尝试写到 openspec 目录层级
+      // 尝试写到 jsspec 目录层级
       fs.writeFileSync(
         path.join(__dirname, '..', '..', '..', '.workflow-validation-result.json'),
         resultJson