jsharness 1.8.2 → 1.8.3

package/.harness/agents/code-reviewer.md

@@ -23,7 +23,7 @@ permissions:
 safetyLevel: low
 dependencies:
   - developer
-outputFormat: review-report-pr-{n}.md
+outputFormat: .harness/doc/codereview/review-report-pr-{n}.md
 ---
 
 # 代码审查 Agent

package/.harness/agents/developer/contract.yaml

@@ -37,7 +37,6 @@ safetyLevel: medium
 dependencies:
   - solution-designer
   - code-reviewer
-outputFormat: "src/**/*.{ts,tsx,java,vue}"
 
 responsibilities:
   - 按设计文档编写代码

package/.harness/agents/developer/prompt.md

@@ -31,7 +31,6 @@ safetyLevel: medium
 dependencies:
   - solution-designer
   - code-reviewer
-outputFormat: src/**/*.{ts,tsx,java,vue}
 ---
 
 # 开发实现 Agent

package/.harness/agents/developer.md

@@ -31,7 +31,6 @@ safetyLevel: medium
 dependencies:
   - solution-designer
   - code-reviewer
-outputFormat: src/**/*.{ts,tsx,java,vue}
 ---
 
 # 开发实现 Agent

package/.harness/agents/gate-controller/contract.yaml

@@ -32,7 +32,7 @@ safetyLevel: medium
 dependencies:
   - solution-designer
   - code-reviewer
-outputFormat: gate-decision.json
+outputFormat: .harness/doc/gate-report/gate-decision.json
 
 responsibilities:
   - 评估技术方案的可行性

package/.harness/agents/gate-controller/prompt.md

@@ -26,7 +26,7 @@ safetyLevel: medium
 dependencies:
   - solution-designer
   - code-reviewer
-outputFormat: gate-decision.json
+outputFormat: .harness/doc/gate-report/gate-decision.json
 ---
 
 # 闸门总控 Agent

package/.harness/agents/gate-controller.md

@@ -26,7 +26,7 @@ safetyLevel: medium
 dependencies:
   - solution-designer
   - code-reviewer
-outputFormat: gate-decision.json
+outputFormat: .harness/doc/gate-report/gate-decision.json
 ---
 
 # 闸门总控 Agent

package/.harness/agents/project-manager/contract.yaml

@@ -29,7 +29,7 @@ permissions:
 
 safetyLevel: low
 dependencies: []
-outputFormat: routing-decision.md
+outputFormat: .harness/doc/project/routing-decision.md
 
 responsibilities:
   - 接收需求，判断其类型（新功能/Bug/热修复/文档等）

package/.harness/agents/project-manager/prompt.md

@@ -23,7 +23,7 @@ permissions:
   - read
 safetyLevel: low
 dependencies: []
-outputFormat: routing-decision.md
+outputFormat: .harness/doc/project/routing-decision.md
 ---
 
 # PM 路由 Agent

package/.harness/agents/project-manager.md

@@ -23,7 +23,7 @@ permissions:
   - read
 safetyLevel: low
 dependencies: []
-outputFormat: routing-decision.md
+outputFormat: .harness/doc/project/routing-decision.md
 ---
 
 # PM 路由 Agent

package/.harness/agents/requirements-analyst/contract.yaml

@@ -1,5 +1,5 @@
 name: requirements-analyst
-description: 需求分析Agent，将原始需求转化为结构化需求文档、验收标准和用户故事
+description: 需求分析Agent，将原始需求转化为结构化需求文档、验收标准和用户故事，使用 prd-generator 技能生成标准化 PRD
 version: "1.0.0"
 
 tools:
@@ -30,7 +30,7 @@ permissions:
 safetyLevel: low
 dependencies:
   - project-manager
-outputFormat: requirements-{task-id}.md
+outputFormat: .harness/doc/prd/requirements-{task-id}.md
 
 responsibilities:
   - 将模糊的原始需求转化为结构化规格说明

package/.harness/agents/requirements-analyst/prompt.md

@@ -1,6 +1,6 @@
 ---
 name: requirements-analyst
-description: 需求分析Agent，将原始需求转化为结构化需求文档、验收标准和用户故事
+description: 需求分析Agent，将原始需求转化为结构化需求文档、验收标准和用户故事，使用 prd-generator 技能生成标准化 PRD
 tools:
   - search_content
   - read_file
@@ -24,7 +24,7 @@ permissions:
 safetyLevel: low
 dependencies:
   - project-manager
-outputFormat: requirements-{task-id}.md
+outputFormat: .harness/doc/prd/requirements-{task-id}.md
 ---
 
 # 需求分析 Agent
@@ -63,28 +63,7 @@ outputFormat: requirements-{task-id}.md
 - 用户故事遵循"作为...我想要...以便于..."格式
 
 ## 需求文档模板
-```markdown
-# 需求文档：{标题}
 
-## 背景（Why）
-- 业务背景和动机
-- 当前痛点
-- 期望达到的效果
-
-## 目标（What）
-- 功能性需求（FR-001 ~ FR-n）
-- 非功能性需求（NFR-001 ~ NFR-n）
-
-## 范围边界
-- **包含**: 本次要做的事
-- **不包含**: 明确排除的范围（防止范围蔓延）
-- **依赖**: 外部依赖和前置条件
-
-## 用户故事
-作为 {角色}，我想要 {功能}，以便于 {价值}
-
-## 验收标准（AC）
-- AC-1: [Given/When/Then 格式的可测试条件]
-- AC-2: [...]
-- AC-n: [...]
-```
+> **强制**：所有需求文档必须使用 `prd-generator` 技能生成标准化 PRD，该技能提供了十大章节的完整模板（背景、用户角色、业务主流程、用户故事、系统用户与功能结构、功能清单、功能详细描述、产品运行分析、非功能性需求、附录），确保需求分析的完整性和可追溯性。
+>
+> 不得使用简化版模板或自定义格式，所有需求必须按照 PRD 标准版输出。

package/.harness/agents/requirements-analyst.md

@@ -1,6 +1,6 @@
 ---
 name: requirements-analyst
-description: 需求分析Agent，将原始需求转化为结构化需求文档、验收标准和用户故事
+description: 需求分析Agent，将原始需求转化为结构化需求文档、验收标准和用户故事，使用 prd-generator 技能生成标准化 PRD
 tools:
   - search_content
   - read_file
@@ -24,7 +24,7 @@ permissions:
 safetyLevel: low
 dependencies:
   - project-manager
-outputFormat: requirements-{task-id}.md
+outputFormat: .harness/doc/prd/requirements-{task-id}.md
 ---
 
 # 需求分析 Agent
@@ -63,28 +63,7 @@ outputFormat: requirements-{task-id}.md
 - 用户故事遵循"作为...我想要...以便于..."格式
 
 ## 需求文档模板
-```markdown
-# 需求文档：{标题}
 
-## 背景（Why）
-- 业务背景和动机
-- 当前痛点
-- 期望达到的效果
-
-## 目标（What）
-- 功能性需求（FR-001 ~ FR-n）
-- 非功能性需求（NFR-001 ~ NFR-n）
-
-## 范围边界
-- **包含**: 本次要做的事
-- **不包含**: 明确排除的范围（防止范围蔓延）
-- **依赖**: 外部依赖和前置条件
-
-## 用户故事
-作为 {角色}，我想要 {功能}，以便于 {价值}
-
-## 验收标准（AC）
-- AC-1: [Given/When/Then 格式的可测试条件]
-- AC-2: [...]
-- AC-n: [...]
-```
+> **强制**：所有需求文档必须使用 `prd-generator` 技能生成标准化 PRD，该技能提供了十大章节的完整模板（背景、用户角色、业务主流程、用户故事、系统用户与功能结构、功能清单、功能详细描述、产品运行分析、非功能性需求、附录），确保需求分析的完整性和可追溯性。
+>
+> 不得使用简化版模板或自定义格式，所有需求必须按照 PRD 标准版输出。

package/.harness/agents/solution-designer/contract.yaml

@@ -32,7 +32,7 @@ permissions:
 safetyLevel: low
 dependencies:
   - requirements-analyst
-outputFormat: design-{task-id}.md
+outputFormat: .harness/doc/design/design-{task-id}.md
 
 responsibilities:
   - 基于需求文档输出完整技术方案

package/.harness/agents/solution-designer/prompt.md

@@ -26,7 +26,7 @@ permissions:
 safetyLevel: low
 dependencies:
   - requirements-analyst
-outputFormat: design-{task-id}.md
+outputFormat: .harness/doc/design/design-{task-id}.md
 ---
 
 # 方案设计 Agent

package/.harness/agents/solution-designer.md

@@ -26,7 +26,7 @@ permissions:
 safetyLevel: low
 dependencies:
   - requirements-analyst
-outputFormat: design-{task-id}.md
+outputFormat: .harness/doc/design/design-{task-id}.md
 ---
 
 # 方案设计 Agent

package/.harness/agents/tester/contract.yaml

@@ -36,7 +36,7 @@ safetyLevel: medium
 dependencies:
   - developer
   - code-reviewer
-outputFormat: test-report-{task-id}.md
+outputFormat: .harness/doc/test-report/test-report-{task-id}.md
 
 responsibilities:
   - 制定测试策略和计划

package/.harness/agents/tester/prompt.md

@@ -30,7 +30,7 @@ safetyLevel: medium
 dependencies:
   - developer
   - code-reviewer
-outputFormat: test-report-{task-id}.md
+outputFormat: .harness/doc/test-report/test-report-{task-id}.md
 ---
 
 # 测试验证 Agent

package/.harness/agents/tester.md

@@ -30,7 +30,7 @@ safetyLevel: medium
 dependencies:
   - developer
   - code-reviewer
-outputFormat: test-report-{task-id}.md
+outputFormat: .harness/doc/test-report/test-report-{task-id}.md
 ---
 
 # 测试验证 Agent

package/.harness/dev-map/overview.md

@@ -251,11 +251,12 @@ project-root/                          # 项目根目录
 | 规范层级 | 入口 | 与本项目的对应关系 |
 |---------|------|-------------------|
 | ⚡ Gate 门禁 | `.harness/gate/checks/` | 自动检测 pom.xml→Java门禁(build-gates-java.js: mvn compile/test/checkstyle/spotbugs/jacoco) / package.json→前端门禁(build-gates-frontend.js: tsc/npm/eslint/audit) |
-| 📘 Skills 技能 | `.harness/skills/` | test-unit(JUnit5+Mockito+JaCoCo)/lint-check(Checkstyle+PMD+SpotBugs+SonarQube)/test-api(REST Assured+WireMock)/test-e2e(Testcontainers+Spring Profiles) 均含 Java 章节；build 已废弃→分流到 java-build / vue-frontend-build |
-| 🔄 Workflow | `.harness/workflow/definition.yaml` | 条件引用 `java-build | vue-frontend-build`；output_formats 含 .java；rules 引用 java-backend.md + frontend-vue3.md |
-| 🤖 Agents | `.harness/agents/` | Developer contract 输出格式含 .java / *Test.java；编码流程含双技术栈说明；质量要求双列（前端标准/后端Java标准）|
+| 📘 Skills 技能 | `.harness/skills/` | 12个技能：architecture-designer(C4/领域模型)/prd-generator(PRD生成)/code-review(前端+后端)/test-unit/lint-check/test-api/test-e2e/java-build/vue-frontend-build/docker-build/docs-update/task-board-maintenance |
+| 🔄 Workflow | `.harness/workflow/definition.yaml` | 条件引用 `java-build \| vue-frontend-build`；7阶段状态机+4流程变体；rules引用java-backend.md+frontend-vue3.md+design-document-boundary.md |
+| 🤖 Agents | `.harness/agents/` | 7个Agent三件套(.md+prompt.md+contract.yaml)：PM→需求分析→方案设计→闸门→开发→审查→测试；输出统一到 `.harness/doc/` |
 | 🔌 MCP 工具 | `.harness/mcp/config.yaml` | 注册 SonarQube(metrics/quality_gate)、Maven(dependency_info/central_search)、Jenkins(maven_job_status) 工具定义 |
-| 📋 Rules | `.harness/rules/project/` | **java-backend.md**(四层架构/9种类后缀/Mapper纯接口/SM4加密/Nacos/VT/22项审查清单) + **frontend-vue3.md**(Composition API强制/Pinia/Element Plus/TS类型安全/7项禁止清单) 双规则集 |
+| 📋 Rules | `.harness/rules/` | **global**: coding-standard(A01-A31)/commit-convention/security-baseline(SM4/注入/脱敏)/process-discipline(三步验证)/design-document-boundary(复杂度分流)；**project**: java-backend(22项CR)+frontend-vue3(7项禁止)+web-specific(i18n/API) |
+| 📄 输出文档 | `.harness/doc/` | prd/ / design/ / gate-report/ / codereview/ / test-report/ / project/ |
 
 ## 维护纪律
 

package/.harness/skills/architecture-designer/SKILL.md

@@ -3,6 +3,7 @@ name: architecture-designer
 description: 专业架构设计技能 — C4 架构模型、用例图、领域模型、服务设计、ER图、类图的全套设计模板和 Mermaid 规范，支持简单/复杂需求分流
 alwaysApply: false
 enabled: true
+outputPath: .harness/doc/design/
 ---
 
 # Architecture Designer Skill
@@ -10,6 +11,7 @@ enabled: true
 > **Skill 类型**: 方案设计辅助 Skill
 > **触发场景**: 系统架构方案设计、技术设计文档编写、多维度架构评审优化
 > **所属 Agent**: solution-designer（方案设计师在方案设计阶段引用本 skill）
+> **输出路径**: 生成的架构设计文档写入项目根目录下 `.harness/doc/design/` 目录
 
 ---
 

package/.harness/skills/docs-update/SKILL.md

@@ -3,12 +3,14 @@ name: docs-update
 description: 文档更新技能 — CHANGELOG 更新、API 文档生成（JSDoc/Swagger）、README 维护、dev-map 同步及 ADR 决策记录
 alwaysApply: false
 enabled: true
+outputPath: .harness/doc/
 ---
 
 # 文档更新技能 (docs-update)
 
 > **执行角色**: 开发实现 Agent / 需求分析 Agent / 方案设计 Agent
 > **触发时机**: 每次代码变更后、阶段交付前
+> **输出路径**: 文档更新产物写入项目根目录下 `.harness/doc/` 目录（CHANGELOG、ADR 等按子目录组织）
 
 ---