svharness 0.14.7 → 0.14.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svharness",
-  "version": "0.14.7",
+  "version": "0.14.8",
   "description": "CLI scaffolder for SDD-Driven Agent-Agnostic Coding Framework (harness)",
   "bin": {
     "svharness": "./bin/cli.js",

package/templates/_shared/apply-skills/README.md

@@ -0,0 +1,139 @@
+# Apply Skills 目录
+
+> 本目录包含 `svharness apply` 生成的运行期 skills，用于引导 Agent 完成业务开发。
+
+## Skills 列表
+
+| Skill | 用途 | 触发语示例 |
+|-------|------|-----------|
+| `harness-apply-skills-main` | 薄索引入口 | "使用 harness 开发 xxx" |
+| `harness-apply-create-task` | 任务创建器 | "创建任务"、"新建任务" |
+| `harness-apply-execute-task` | 任务执行器 | "执行任务"、"继续开发" |
+| `harness-apply-review-task` | 任务审查器 | "审查任务"、"review task" |
+
+## 任务生命周期
+
+```mermaid
+graph LR
+    A[harness-apply-create-task] -->|写入| B[task-list.yaml]
+    B -->|读取| C[harness-apply-execute-task]
+    C -->|写入| D[执行状态/证据]
+    D -->|读取| E[harness-apply-review-task]
+    E -->|反馈| B
+    
+    F[specs/] --> A
+    G[requirements/] --> A
+    H[rules/] --> A
+    I[baseline/] --> A
+```
+
+### 流程说明
+
+1. **创建任务** (`harness-apply-create-task`)
+   - 搜索 requirements/specs/rules/baseline
+   - 确定任务类型
+   - 创建任务定义
+   - 对抗性审查
+   - 写入 task-list.yaml
+
+2. **执行任务** (`harness-apply-execute-task`)
+   - 读取 task-list.yaml
+   - 认领 pending 任务
+   - 按步骤执行
+   - 收集证据
+   - 提交审查
+
+3. **审查任务** (`harness-apply-review-task`)
+   - 读取任务执行结果
+   - 五维度审查
+   - 对抗性挑战
+   - 输出结论
+   - 更新任务状态
+
+## 文件结构
+
+```
+tasks/
+├── task-list.yaml                          # 统一任务列表
+├── templates/                              # 任务模板
+│   ├── index.yaml                          # 模板索引
+│   ├── feature/                            # 功能开发模板
+│   ├── fix/                                # Bug 修复模板
+│   ├── refactor/                           # 重构模板
+│   ├── test/                               # 测试模板
+│   ├── review/                             # 审查模板
+│   └── batch/                              # 批量开发模板
+└── evidence/                               # 证据目录
+    └── <task-id>/                          # 每任务证据
+```
+
+## 任务状态流转
+
+```
+pending → in_progress → review_pending → done
+    ↑           ↓              ↓
+    └───────────┴──────────────┘ (blocked)
+```
+
+| 状态 | 说明 | 触发条件 |
+|------|------|----------|
+| `pending` | 待执行 | 任务创建后初始状态 |
+| `in_progress` | 执行中 | 被 execute-task 认领 |
+| `review_pending` | 待审查 | 执行完成，提交审查 |
+| `done` | 完成 | 审查通过 |
+| `blocked` | 阻塞 | 执行或审查中遇到阻塞 |
+| `waived` | 豁免 | 人工决定跳过 |
+
+## 与其他 Skills 的关系
+
+| Skill | 用途 | 与本目录 skills 的关系 |
+|-------|------|------------------------|
+| `harness-apply-zhangyong-voice-tts` | 特定战役执行 | 参考实现，可复用任务结构 |
+| `harness-android-architecture` | MVI 架构指引 | create-task 时参考 |
+| `harness-compose-ui` | Compose UI 指引 | execute-task 时参考 |
+| `harness-compose-state` | 状态管理指引 | execute-task 时参考 |
+
+## 使用示例
+
+### 创建任务
+
+```text
+用户: 创建一个任务来实现音频均衡器功能
+Agent: [调用 harness-apply-create-task]
+  → 搜索 specs/behavior/voice-audio.yaml
+  → 搜索 requirements/yaml/
+  → 创建 TASK-001 (feature)
+  → 对抗性审查通过
+  → 写入 task-list.yaml
+```
+
+### 执行任务
+
+```text
+用户: 执行下一个任务
+Agent: [调用 harness-apply-execute-task]
+  → 读取 task-list.yaml
+  → 认领 TASK-001
+  → 按步骤执行
+  → 收集证据
+  → 标记为 review_pending
+```
+
+### 审查任务
+
+```text
+用户: 审查 TASK-001
+Agent: [调用 harness-apply-review-task]
+  → 读取 TASK-001 执行结果
+  → 五维度审查
+  → 对抗性挑战
+  → 输出 APPROVE
+  → 标记为 done
+```
+
+## 相关文档
+
+- `tasks/templates/index.yaml` — 任务模板索引
+- `tasks/task-list.yaml` — 统一任务列表骨架
+- `agent-env/review-profiles/` — 审查配置
+- `harness-apply-three-layer-architecture.md` — 三层架构设计

package/templates/_shared/apply-skills/harness-apply-create-task.md

@@ -0,0 +1,295 @@
+---
+name: harness-apply-create-task
+description: >
+  通用任务创建 skill。引导 Agent 搜索相关需求/specs/rules/baseline，
+  创建各种类型的任务（feature/fix/refactor/test/review），记录到任务列表，
+  并以对抗性思维对创建的任务进行审查。
+  触发语：创建任务、新建任务、create task、add task、我要开发xxx、实现xxx功能。
+---
+
+# harness-apply-create-task（任务创建器）
+
+你是 **任务创建器**。负责从需求/specs 中提取可执行任务，写入任务列表，并进行对抗性自审。
+
+## 绑定元数据
+
+```yaml
+harness_root_rel: __HARNESS_ROOT_REL__
+task_list_rel: tasks/task-list.yaml
+templates_rel: tasks/templates
+```
+
+## 核心流程
+
+```
+Phase 1: 搜索与理解
+  ↓
+Phase 2: 确定任务类型
+  ↓
+Phase 3: 创建任务
+  ↓
+Phase 4: 对抗性审查
+  ↓
+Phase 5: 写入任务列表
+```
+
+---
+
+## Phase 1: 搜索与理解
+
+**目标**：全面收集与任务相关的信息，建立上下文。
+
+### 1.1 必读文档（按顺序）
+
+| 序号 | 文档 | 路径 | 用途 |
+|------|------|------|------|
+| 1 | harness 清单 | `harness.yaml` | 了解 harness 基本信息（name、arch、agent） |
+| 2 | 应用期约束 | `AGENTS_APPLY.md` | 了解 apply 期强约束 |
+| 3 | 任务模板索引 | `tasks/templates/index.yaml` | 了解可用的任务模板 |
+| 4 | 任务列表 | `tasks/task-list.yaml` | 了解已有任务，避免重复 |
+
+### 1.2 搜索相关信息
+
+根据用户需求，搜索以下目录中的相关内容：
+
+| 搜索目标 | 路径 | 搜索方式 |
+|----------|------|----------|
+| 需求条目 | `requirements/yaml/*.yaml` | 按关键词/REQ-ID 搜索 |
+| 行为规格 | `specs/behavior/*.yaml` | 按模块/功能搜索 |
+| 信号规格 | `specs/signals/*.yaml` | 按信号名/CMDID 搜索 |
+| UI 规格 | `specs/ui/*.yaml` | 按组件/TTS 搜索 |
+| 接口规格 | `specs/interfaces/*.yaml` | 按接口名搜索 |
+| 架构规则 | `agent-env/rules/*.md` | 加载 alwaysApply 规则 |
+| 基线参考 | `baseline/code/` | 查找同类实现样本 |
+| 已有任务 | `tasks/task-list.yaml` | 检查是否已存在相关任务 |
+
+### 1.3 输出：任务上下文
+
+```yaml
+task_context:
+  req_ids: []           # 相关需求 ID
+  spec_paths: []        # 相关规格路径
+  rule_refs: []         # 相关规则
+  baseline_refs: []     # 基线参考
+  module_name: ""       # 目标模块
+  feature_domain: ""    # 功能域
+```
+
+---
+
+## Phase 2: 确定任务类型
+
+根据搜索结果，确定任务类型：
+
+| 类型 | 触发条件 | 模板路径 |
+|------|----------|----------|
+| **feature** | 新增功能/信号/接口/UI | `tasks/templates/feature/` |
+| **fix** | Bug 修复/问题排查 | `tasks/templates/fix/` |
+| **refactor** | 架构重构/代码优化 | `tasks/templates/refactor/` |
+| **test** | 测试验证/覆盖率提升 | `tasks/templates/test/` |
+| **review** | 代码审查/规格验证 | `tasks/templates/review/` |
+| **batch** | 跨模块批量开发 | `tasks/templates/batch/` |
+
+**选择规则**：
+1. 用户明确指定类型 → 使用指定类型
+2. 用户描述为"新增/实现/开发" → feature
+3. 用户描述为"修复/fix/bug" → fix
+4. 用户描述为"重构/优化/迁移" → refactor
+5. 用户描述为"测试/验证" → test
+6. 用户描述为"审查/review" → review
+7. 用户描述为"批量/整包/跨模块" → batch
+
+---
+
+## Phase 3: 创建任务
+
+### 3.1 读取模板
+
+根据任务类型，读取对应的模板文件：
+
+```
+tasks/templates/<type>/<template>.md
+```
+
+### 3.2 生成任务 ID
+
+格式：`TASK-<序号>`
+
+序号规则：
+- 从 `tasks/task-list.yaml` 中获取当前最大序号
+- 新任务序号 = 最大序号 + 1
+- 示例：TASK-001、TASK-002、TASK-003
+
+### 3.3 填充任务定义
+
+```yaml
+- id: "TASK-XXX"
+  type: <feature|fix|refactor|test|review|batch>
+  title: "任务标题（简洁明了）"
+  description: "任务描述（详细说明做什么）"
+  status: pending
+  priority: <P0|P1|P2>  # P0=紧急, P1=重要, P2=普通
+  created_at: "<当前时间>"
+  updated_at: "<当前时间>"
+  
+  # 来源追溯
+  req_ids: [<REQ-ID 列表>]
+  spec_paths: [<规格路径列表>]
+  
+  # 执行定义
+  template: "tasks/templates/<type>/<template>.md"
+  inputs:  # 模板输入参数
+    <param>: <value>
+  steps:   # 从模板继承的步骤
+    - id: <step-id>
+      status: pending
+  
+  # 审查记录（初始为空）
+  review:
+    status: pending
+    reviewer: null
+    dimensions: []
+  
+  # 证据（初始为空）
+  evidence: []
+```
+
+---
+
+## Phase 4: 对抗性审查
+
+**目标**：以对抗性思维检查任务定义的质量。
+
+### 4.1 检查清单
+
+| 检查项 | 说明 | 失败处理 |
+|--------|------|----------|
+| **重复检查** | 是否与已有任务重复 | 拒绝创建，提示已有任务 ID |
+| **依赖检查** | 依赖的任务是否存在 | 提示缺失的依赖任务 |
+| **spec 覆盖** | 是否覆盖了所有相关 spec | 提示遗漏的 spec |
+| **REQ 覆盖** | 是否关联了所有相关 REQ | 提示遗漏的 REQ |
+| **验收标准** | acceptance 是否可测试 | 要求补充可测试的验收标准 |
+| **模板匹配** | 选择的模板是否合适 | 建议更合适的模板 |
+| **粒度检查** | 任务粒度是否合适（不过大/过小） | 建议拆分或合并 |
+
+### 4.2 对抗性挑战
+
+针对任务定义提出质疑：
+
+1. **边界条件**：是否考虑了所有边界条件？
+2. **异常场景**：异常场景如何处理？
+3. **性能影响**：对性能有何影响？
+4. **安全风险**：是否存在安全隐患？
+5. **向后兼容**：是否破坏现有功能？
+
+### 4.3 输出：审查结论
+
+```yaml
+adversarial_review:
+  passed: true|false
+  checks:
+    - name: "重复检查"
+      status: pass|fail
+      detail: ""
+    - name: "依赖检查"
+      status: pass|fail
+      detail: ""
+    # ...
+  challenges:
+    - question: "边界条件处理？"
+      answer: "..."
+    # ...
+  conclusion: "approve|reject|needs_revision"
+  revision_notes: []  # 如需修改，列出修改项
+```
+
+---
+
+## Phase 5: 写入任务列表
+
+### 5.1 读取现有任务列表
+
+```yaml
+# tasks/task-list.yaml
+schema_version: "1.0"
+updated_at: "..."
+summary:
+  total: N
+  pending: N
+  # ...
+tasks:
+  - id: TASK-001
+    # ...
+```
+
+如果文件不存在，创建初始结构。
+
+### 5.2 追加新任务
+
+将新任务追加到 `tasks` 数组中。
+
+### 5.3 更新统计
+
+更新 `summary` 中的统计数据。
+
+### 5.4 写入文件
+
+将更新后的内容写入 `tasks/task-list.yaml`。
+
+---
+
+## 输出格式
+
+### 成功创建
+
+```markdown
+## 任务创建成功
+
+- **任务 ID**: TASK-XXX
+- **类型**: feature
+- **标题**: xxx
+- **优先级**: P1
+
+### 对抗性审查
+- 重复检查: PASS
+- 依赖检查: PASS
+- spec 覆盖: PASS
+- 验收标准: PASS
+
+### 后续步骤
+1. 使用 `harness-apply-execute-task` 执行任务
+2. 使用 `harness-apply-review-task` 审查执行结果
+```
+
+### 创建失败
+
+```markdown
+## 任务创建失败
+
+- **原因**: 与已有任务 TASK-YYY 重复
+- **建议**: 修改 TASK-YYY 或合并任务
+
+### 对抗性审查
+- 重复检查: FAIL (与 TASK-YYY 重复)
+- 依赖检查: PASS
+- spec 覆盖: PASS
+- 验收标准: PASS
+```
+
+---
+
+## 守则
+
+1. **不猜测**：不确定的信息必须询问用户
+2. **不重复**：创建前必须检查已有任务
+3. **可追溯**：每个任务必须关联 req_ids 或 spec_paths
+4. **可测试**：验收标准必须可自动化或手动验证
+5. **对抗性**：必须以对抗性思维审查任务定义
+
+## 典型触发语
+
+- "创建一个任务来实现 xxx 功能"
+- "新建一个 bug 修复任务"
+- "我要开发 xxx，帮我创建任务"
+- "为 specs/behavior/voice-audio.yaml 创建开发任务"
+- "add task for xxx"