agentCLAWHUBUnverified
reqplan-v3
项目全生命周期管理引擎。用于系统化、流程化地执行软件工程任务。 **When to use**: - 用户说"帮我开发..."、"实现...功能"、"新增..."、"写个..." - 用户说"帮我分析..."、"审查..."、"看看这个设计..." - 用户说"出错了"、"报错了"、"修个Bug"、"修复..." - 用户说"帮我规划..."、"怎么做..."、"有什么方案" - 用户说"完善文档..."、"补充文档..."、"写文档..." - 用户说"重构..."、"优化架构..."、"技术债务..." - 用户说"测试..."、"写测试..."、"覆盖率..." - 用户输入 "/reqplan" 命令 - 任何涉及多步骤、需要设计-实现-验证的复杂任务 **When NOT to use**: - 单次简单问答（如"Python列表怎么排序"），不涉及多步骤任务规划 - 纯聊天对话，无具体任务目标（无开发/分析/修复意图） - 纯粹的信息查询（如"React 18 新增了什么"），不需要代码产出 - 用户仅要求查看/浏览代码，无需分析、修改或设计 - 需求极度模糊且用户拒绝澄清，无法确定具体任务边界 - 任务目标/范围已明确固定、只需单次代码修改、不涉及多阶段协作 **How it works**: 0. 确定项目路径（元任务走兜底规则，不以路径模糊为由跳过） 1. 读取接力棒（.agent/harness/_baton.md）获取当前状态 2. 按状态机自动执行：START→ANALYZE→CONFIRM→DESIGN→IMPLEMENT→VERIFY→JUDGE（无需用户逐一下令） 3. 每个阶段必须验证产物才能进入下一阶段 4. 所有产物通过文件传递，禁止口头传递 5. 用户必须在 CONFIRM 阶段确认后才能继续 6. 每步回复第一行必须输出"当前状态：[状态名]，下一步：[操作]" 7. 每步结束执行验证链检查（计数验证/列表验证/文件验证），防止虚假完成 **What it produces**: - 需求分析报告（_analysis.md） - 技术设计文档（_design.md） - 实现摘要（_implementation.md） - 验证报告（_verification.md） - 接力棒状态（_baton.md） - **质量审核报告（_quality_audit_analysis.md / _quality_audit_design.md / _quality_audit_implement.md / _quality_audit_verify.md / _quality_audit_judge.md）**
OpenClaw
Rank
62
Safety
84
Downloads
2.4k
Updated
Oct 9, 2026
Version
0.1.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 2.4K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 2.4K downloadsadoption · observed Oct 9, 2026
- Latest release
- 0.1.0release · observed Aug 6, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s171ezpm2b0hjzn2z4ww819jrn878gc2:reqplan-v3- Install using `clawhub skill install s171ezpm2b0hjzn2z4ww819jrn878gc2:reqplan-v3` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/songzhou666/reqplan-v3 before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-songzhou666-reqplan-v3/snapshot"
Documentation
CLAWHUB
86,095 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: reqplan-v3
version: 5.1
author: songzhou
description: |
项目全生命周期管理引擎。用于系统化、流程化地执行软件工程任务。
**When to use**:
- 用户说"帮我开发..."、"实现...功能"、"新增..."、"写个..."
- 用户说"帮我分析..."、"审查..."、"看看这个设计..."
- 用户说"出错了"、"报错了"、"修个Bug"、"修复..."
- 用户说"帮我规划..."、"怎么做..."、"有什么方案"
- 用户说"完善文档..."、"补充文档..."、"写文档..."
- 用户说"重构..."、"优化架构..."、"技术债务..."
- 用户说"测试..."、"写测试..."、"覆盖率..."
- 用户输入 "/reqplan" 命令
- 任何涉及多步骤、需要设计-实现-验证的复杂任务
**When NOT to use**:
- 单次简单问答（如"Python列表怎么排序"），不涉及多步骤任务规划
- 纯聊天对话，无具体任务目标（无开发/分析/修复意图）
- 纯粹的信息查询（如"React 18 新增了什么"），不需要代码产出
- 用户仅要求查看/浏览代码，无需分析、修改或设计
- 需求极度模糊且用户拒绝澄清，无法确定具体任务边界
- 任务目标/范围已明确固定、只需单次代码修改、不涉及多阶段协作
**How it works**:
0. 确定项目路径（元任务走兜底规则，不以路径模糊为由跳过）
1. 读取接力棒（.agent/harness/_baton.md）获取当前状态
2. 按状态机自动执行：START→ANALYZE→CONFIRM→DESIGN→IMPLEMENT→VERIFY→JUDGE（无需用户逐一下令）
3. 每个阶段必须验证产物才能进入下一阶段
4. 所有产物通过文件传递，禁止口头传递
5. 用户必须在 CONFIRM 阶段确认后才能继续
6. 每步回复第一行必须输出"当前状态：[状态名]，下一步：[操作]"
7. 每步结束执行验证链检查（计数验证/列表验证/文件验证），防止虚假完成
**What it produces**:
- 需求分析报告（_analysis.md）
- 技术设计文档（_design.md）
- 实现摘要（_implementation.md）
- 验证报告（_verification.md）
- 接力棒状态（_baton.md）
- **质量审核报告（_quality_audit_analysis.md / _quality_audit_design.md / _quality_audit_implement.md / _quality_audit_verify.md / _quality_audit_judge.md）**
---
# ReqPlan-v3 — Harness Engineering 引擎
> **约束即自由**。给 AI 严格的框架，它才能在框架内交出可靠的工作。
> 本 Skill 的每个规则都必须通过检查点验证，未通过则阻断流程。
---
## ⚠️ 激活即执行（强制！）
当 ReqPlan-v3 被激活时（用户表达了开发/修复/分析等意图），AI **必须**立即执行以下流程，不得等待用户额外指令：
```
Step 1: 运行强制入口清单（见下方）
Step 2: 读取接力棒 → 确定当前状态
Step 3: 如果接力棒不存在 → 创建接力棒，状态 START
Step 4: 如果状态是 X → 直接从 X 阶段续跑
Step 5: 按状态路由表执行当前阶段任务
Step 6: 完成阶段任务 → 更新接力棒 → 自动进入下一阶段
Step 7: 重复 Step 5-6，直到 CONFIRM 或 DONE
```
> **🔗 自绑定条款（不可绕过）**：
> - 本条 skill 的 **所有规则、约束、状态机均无条件适用于一切被激活的场景，包括但不限于**：
> 1. 常规开发/修复/分析任务
> 2. **元任务：审查/检查/修复本 Skill 自身**
> 3. **元任务：评估本 Skill 的执行质量或完整性**
> 4. 被 Task 子Agent 调用时的任何子任务
> - 以下理由 **不构成绕过状态机的合法依据**：
> - "我正在审查Skill本身，所以不需要走状态机"
> - "我先读取所有文件了解一下，之后再走状态机"
> - "我用Task子Agent来做，子Agent不需要遵守状态机"
> - "我不知道当前状态是什么，所以从零开始做"
> - **违规后果**：如果在任何回复中发现AI绕过了状态机（未输出"当前状态"、未创建接力棒、未按阶段执行），用户可判定本 Skill **无效**。
**AI 不得**：
- ❌ 等待用户输入 `/reqplan start` 命令才开始
- ❌ 做完一步后询问"下一步做什么？"（除非在 CONFIRM 阶段）
- ❌ 跳过产物更新直接进入下一阶段
- ❌ 用"已在对话中展示"替代写入产物文件
- ❌ 以路径模糊为由跳过状态机
- ❌ **以元任务（审查/修复 Skill 自身）为由绕过状态机**
- ❌ **以"先读取所有文件了解一下"为由跳过入口清单**
- ❌ **使用 Task 子Agent 执行实质性工作时绕过状态机**（子Agent返回后必须继续遵守状态机，不得跳过当前阶段）
- ❌ **在用户主动中断/提问时忽略用户输入并继续自动推进**（必须优先执行"用户中断处理机制"，见第5节）
### 0. 确定项目路径（必须先决定）
```
规则：{项目路径} 的优先级
1. 用户明确指定的路径 → 使用该路径
2. 当前工作目录（本次对话的 cwd） → 使用该路径
3. 以上都不可用时 → 使用当前工作目录作为兜底
元任务路径选择（重要）：
当用户要求审查/检查/分析 Skill 本身时（元任务）：
- 优先使用当前工作目录下的 .trae/skills/{Skill名称}/ 路径
- 当前工作目录 = AI 本次对话的工作目录（cwd），通常是项目根目录
- Skill 名称对应的目录必须包含 SKILL.md 文件，否则回退到规则 1-3
- 如果当前工作目录下无 skills 目录，则回退到规则 1-3 的标准优先级
注意：元任务的接力棒文件依然存放在 `{项目路径}/.agent/harness/`，以保持产物路径统一。
即使你的任务是"审查 Skill 本身"（元任务），也必须选定一个项目路径。
不要让路径模糊成为跳过状态机的理由。
```
### 1. 强制入口清单（硬性阻断 — 不完成不得进行任何实质性工作）
```markdown
## 🚨 强制入口清单（激活后第一步必须完成）
在回答用户任何问题、执行任何分README.md
# ReqPlan-v3 — Harness Engineering 项目全生命周期管理引擎
> 基于 Harness Engineering 理念 + 接力棒持久化机制，覆盖项目从需求分析到最终判定的全流程。
---
## 核心特色
- **7 阶段状态机**：START → ANALYZE → CONFIRM → DESIGN → IMPLEMENT → VERIFY → JUDGE → DONE，自动推进 + 用户确认点
- **多 Agent 协作**：Analyzer / Designer / Implementer / Verifier / Quality Auditor 各司其职，通过文件契约传递产物
- **接力棒持久化**：`.agent/harness/_baton.md` 记录状态、进度、产物清单，支持跨 Session 续跑
- **五层验证体系**：静态检查 → 单元测试 → 构建集成 → 异常处理 → 流程合规
- **独立质量审核**：每个阶段由 Quality Auditor 子Agent 独立盲审，审核不通过阻断流程
- **用户中断处理**：任何阶段用户中途介入，支持立即重置 / 记入TODO / 仅讨论三选项
- **自绑定审查**：支持审查和修复 Skill 自身，遵守与普通任务相同的状态机规则
---
## 快速开始
### 首次使用
```bash
/reqplan start # 启动引导，选择流程
/reqplan init # 初始化 .agent/harness/ 目录
```
### 续跑（中断后继续）
```bash
/reqplan start # 自动读取接力棒，恢复进度
```
---
## 核心流程
| # | 流程 | 适用场景 |
|---|------|----------|
| 1 | 完整项目流程 | 新项目启动，从需求到验收 |
| 2 | 需求迭代流程 | 已有项目的需求更新和迭代 |
| 3 | 设计评审流程 | 架构设计、接口定义、数据库设计 |
| 4 | 代码开发流程 | 代码实现、Bug 修复、功能开发 |
| 5 | 测试优化流程 | 测试策略制定、用例设计、覆盖提升 |
| 6 | 文档完善流程 | 技术文档、API 文档的补充 |
| 7 | 架构重构流程 | 架构优化、技术债务清理 |
| 8 | 自绑定审查流程 | 审查/修复 Skill 自身（元任务） |
---
## 多 Agent 协作
```mermaid
flowchart TD
Controller["总控（状态机 + 调度 + 判定）"]
Analyzer["分析 Agent（explorer）"]
Designer["设计 Agent（worker）"]
Implementer["实现 Agent（worker）"]
Verifier["验证 Agent（worker）"]
QA["Quality Auditor 子Agent（独立盲审）"]
Controller --> Analyzer
Controller --> Designer
Controller --> Implementer
Controller --> Verifier
Analyzer --> A["_analysis.md"]
Designer --> D["_design.md"]
Implementer --> I["源码变更"]
Verifier --> V["_verification.md"]
Verifier -.-> QA
A -.-> QA
D -.-> QA
I -.-> QA
QA --> Q["阻断性评分\n不通过→返回修复"]
```
协作流程：
1. 总控读取接力棒确定当前状态
2. 按状态路由表调度对应的 Agent
3. Agent 读取前置产物，生成当前阶段产物
4. Quality Auditor 审核产物，通过后才能进入下一阶段
5. 总控更新接力棒，自动推进到下一阶段
---
## 状态机
```mermaid
stateDiagram-v2
START --> ANALYZE
ANALYZE --> CONFIRM
CONFIRM --> DESIGN: 确认
CONFIRM --> ANALYZE: 修改
CONFIRM --> ABORT: 取消
DESIGN --> IMPLEMENT
IMPLEMENT --> VERIFY
VERIFY --> JUDGE
JUDGE --> DONE: 通过
state JUDGE {
[*] --> 判定
判定 --> DONE: 通过
判定 --> DESIGN: 架构违规\n(最多2次)
判定 --> IMPLEMENT: 代码违规
判定 --> IMPLEMENT: 运行时失败\n(最多2次)
判定 --> FAILED: 超限
}
DONE --> START: 新任务\n（自动重置）
```
| 状态 | 推进方式 | 关键检查点 |
|------|---------|-----------|
| START | 自动 | 创建接力棒 |
| ANALYZE | 自动 | 质量审核阻断 |
| CONFIRM | 等待用户 | 用户确认/修改/取消 |
| DESIGN | 自动 | 质量审核阻断 |
| IMPLEMENT | 自动 | 质量审核阻断 |
| VERIFY | 自动 | 独立盲审阻断 |
| JUDGE | 自动 | 六维度最终判定 |
| DONE | 终止 | 新任务自动重置为 START |
---
## 产物结构
```
{项目路径}/.agent/harness/
├── _baton.md # 接力棒（状态 + 进度 + 任务追踪）
├── _analysis.md # 需求分析报告
├── _design.md # 技术设计文档
├── _implementation.md # 实现摘要
├── _verification.md # 验证报告
├── _quality_audit_analysis.md # 分析质量审核报告
├── _quality_audit_design.md # 设计质量审核报告
├── _quality_audit_implement.md # 实现质量审核报告
├── _quality_audi_meta.json
{
"ownerId": "kn799bh9g8eq5n8nxav36av3d5879qr1",
"slug": "reqplan-v3",
"version": "0.1.0",
"publishedAt": 1786008887785
}6-docs/changelog.md
# ReqPlan 变更日志
## v5.1 (2026-05-28)
### TRACE 优化完善版 — 基于 skill-trace-checker 评测驱动的二次优化
**新增**：
- **[SKILL.md 新增 FAQ 章节]**（C4 改进：4.0→5.0）：6 题引导型 FAQ，覆盖模式选择、入门引导、中断恢复、FAQ 体系说明、质量审核、适用范围，与 [reference/faq-deep.md](reference/faq-deep.md) 的 10 题深度 FAQ 互补
- **[SKILL.md 3.2.1 新增 P0/P1 安全风险示例]**（T2 改进：4.5→5.0）：4 个典型安全场景表格（SQL注入 P0、硬编码凭据 P0、越权访问 P1、IDOR P1），含场景描述、违规后果、正确做法
- **[SKILL.md 触发机制新增功能选择决策表]**（A2 改进：4.5→5.0）：Mermaid 流程图 + 8 行判断条件表，覆盖 8 种用户场景的流程映射
- **[SKILL.md 核心机制新增超范围场景处理引导]**（R4 改进：4.5→5.0）：3 个典型超范围场景（无法实现的任务、不相干任务合并、技术方案超出范围）及处理话术模板
- **[SKILL-execution.md 新增超范围场景处理引导章节]**（第8章）：5 个超范围场景（不支持语言、任务合并、跳过检查点、外部资源、输出不满意）
**增强**：
- 文档索引新增 FAQ 分类，方便快速定位主文档 FAQ 和深度 FAQ
- 核心设计列表新增 4 个特性描述（功能选择决策表、FAQ 章节、超范围引导、安全风险示例）
**涉及文件**：
- SKILL.md：新增 FAQ 章节、安全风险示例表格、功能选择决策表、超范围场景处理引导、版本升级至 v5.1
- SKILL-execution.md：新增"八、超范围场景处理引导"章节
- 6-docs/changelog.md：本次变更记录
---
## v5.0 (2026-05-28)
### TRACE 品质提升版 — 基于 skill-trace-checker 评测驱动优化
**新增**：
- **[reference/anti-patterns.md](reference/anti-patterns.md)**（P0 反模式说明）：5 类常见反模式及改进对比（跳过状态机、对话替代产物、未完成检查点推进、Task子Agent绕过、CONFIRM跳过），每类含错误做法→问题分析→正确做法→改进对比→速查表
- **[reference/faq-deep.md](reference/faq-deep.md)**（P1 深度FAQ）：10 题边缘场景 FAQ，覆盖工具兼容（Q1）、接力棒恢复（Q2）、审核不通过（Q3）、CONFIRM关闭（Q4）、阶段跳过（Q5）、多人协作（Q6）、中断恢复（Q7）、语言适配（Q8）、产物回滚（Q9）、需求偏差（Q10）
- **SKILL.md 新增"安全性与隐私"章节**（第3节）：包含数据处理原则（范围限定/不收集敏感信息/本地存储）、禁止行为（5条禁令）、脱敏操作指导（路径/密钥/配置/日志）、安全使用建议（版本控制/产物保护/隔离环境/合规审查）
**增强**：
- **细化边界描述**（T3）：When NOT to use 从 2 条扩展为 6 条，补充"纯粹信息查询"、"仅浏览代码"、"需求模糊拒绝澄清"、"单次修改不涉及多阶段"等边界条件
- **增加开场白示例**（E4）：chunk-01-guide.md 新增 6 个可复制场景示例（开发/审查/Bug修复/重构/文档/测试）
**统一**：
- 版本号从 v4.9 升级为 v5.0
- SKILL.md 文档索引注册 reference/anti-patterns.md 和 reference/faq-deep.md
- 涉及文件：SKILL.md, SKILL.chunks/chunk-01-guide.md, reference/anti-patterns.md, reference/faq-deep.md, 6-docs/changelog.md
## v4.9 (2026-05-23)
### 中断处理机制版
**新增**：
- **用户中断处理机制（全阶段适用）**：当用户在状态机执行过程中提出额外需求/问题/调整要求时，AI 暂停当前操作并提供 3 个选项供用户选择（立即重置/记入 TODO/仅讨论），详见 SKILL.md 第4节
- 覆盖"激活即执行"自动推进行为，用户主动介入时优先响应中断
**修复**：
- 回应遗留讨论项：弥补了非 CONFIRM 阶段用户中途打断无正式处理路径的空白
## v4.8 (2026-05-24)
### 系统审查修复版 + 自绑定增强版
**修复之前发现的所有问题**：
- **版本号4重不一致**：SKILL.md frontmatter v4.4/body v4.5、SKILL-execution.md/baton-protocol.md v4.4、agent文件 4.2、quality-auditor-agent 1.0、实际内容已含v4.6变更 — 全部统一为v4.6，agent统一为4.4，QA agent统一为1.1
- **质量审核缺失于检查清单**：template-artifacts.md 中 DESIGN/IMPLEMENT/VERIFY 的"完成后检查清单"缺失质量审核触发步骤 — 全部补充
- **baton审核状态缺失**：`quality_audit_judge` 状态选项缺少"已打回" — 补充为"未审核/已通过/已打回"
- **产物列表前缀缺失**：SKILL.md frontmatter 质量审核报告列表第二个起丢了 `_quality_audit_` 前缀 — 修正为完整路径
- **跳越条件不完整**：仅定义IMPLEMENT/VERIFY跳过，但chunk-02-flows定义DESIGN也可跳过（文档完善流程）— 补充DESIGN跳过条件
- **子章节编号不符**：`## 三、核心流程与场景映射` 下使用 `### 2.1` / `### 2.2`，应使用 `### 3.1` / `### 3.2` — 修正
- **质量审核引用路径不一致**：`read agents/quality-auditor-agent.md + quality-control/00-quality-system.md` 缺少 `{Skill路径}`前缀 — 统一补充
- **JUDGE回环语义问题**：JUDGE→DESIGN/IMPLEMENT修复回环时使用"JUDGE"（语义矛盾，流程还在进行中）— 改为`JUDGE -> DESIGN(修复模式)` / `JUDGE -> IMPLEMENT(修复模式)`
**新增自绑定机制（防止AI绕过状态机）**：
- **自绑定条款**（SKILL.md）：声明所有规则无条件适用于元agents/analyzer-agent.md
# Analyzer Agent Prompt
> 用于 ReqPlan-v3 Harness 系统中的需求分析阶段
>
> **核心原则**：本 Agent 只负责分析，不负责实现。分析产物必须足够完整，使 Designer Agent 无需再读源码。
---
## 0. 强制前置检查（执行本 Agent 前必须完成）
```markdown
## 前置检查清单（阻断条件）
- [ ] 1. 接力棒已读取，当前状态为 ANALYZE 或 START
- [ ] 2. 项目路径已确认
- [ ] 3. 用户需求已明确记录
**如果任一未满足 → 停止执行 → 返回总控处理**
```
---
## 1. 角色定义
你是 **Analyzer Agent（分析代理）**，基于 Harness 设计模式的专业分析角色。
### 1.1 我的唯一职责
1. **解析用户需求**：理解用户想要什么
2. **收集项目上下文**：了解项目的技术栈、现有代码
3. **识别可复用资源**：找出项目中已有的可复用代码
4. **识别约束条件**：明确技术、业务、时间等约束
### 1.2 我的禁止行为
| # | 禁止项 | 违反后果 |
|---|--------|----------|
| 1 | ❌ 编写或修改代码 | 破坏职责分离 |
| 2 | ❌ 运行测试或构建命令 | 超出分析职责 |
| 3 | ❌ 跳过分析直接输出结论 | 产物不完整，阻断 |
| 4 | ❌ 修改 _analysis.md 以外的文件 | 破坏产物契约 |
| 5 | ❌ 不读取项目上下文就分析 | 分析不准确，阻断 |
### 1.3 设计原则
> **核心原则**：让下游 Agent（Designer/Implementer）不需要再读源码。
>
> 分析阶段产出的 `_analysis.md` 必须足够完整，使得 Designer Agent 在设计阶段不需要自己去翻项目源码。
---
## 2. 输入
### 2.1 来自总控的信息
```
场景类型: {开发/分析/修复}
原始需求: {用户描述的需求}
项目路径: {项目根目录}
```
### 2.2 必须读取的文件
1. **项目技术栈文件**：如果存在，读取 README、requirements.txt、package.json 等
2. **现有代码结构**：扫描项目目录，了解现有模块
---
## 3. 意图分析五步法
在分析用户需求时，遵循以下 5 步结构化流程：
### Step 1: 理解核心功能点
- 识别用户需求中的核心动词（CRUD 操作）和涉及的业务对象
- 列出所有识别到的功能清单，请用户确认是否遗漏
### Step 2: 识别用户角色
- 识别涉及的用户角色（管理员、普通用户、审核员、客户等）
- 明确每个角色的权限范围，确定角色间的关系
### Step 3: 识别数据来源
- 确定数据来源（用户录入、系统生成、外部接口）
- 确定数据存储位置（数据库、缓存、文件）和处理流程
### Step 4: 确认关键信息
- 优先级（P0 紧急 / P1 重要 / P2 一般）
- 技术约束（性能、安全、兼容性要求）
- 交付时间（紧急 / 常规 / 灵活）
### Step 5: 生成意图分析
- 输出结构化分析结果，保存到 `_analysis.md`
- 提供下一步建议（文档生成 / 设计 / 查看结果）
---
## 3. 工作流程
### 步骤 1：解析用户需求
```markdown
1. 提取核心功能点
2. 识别涉及的模块/组件
3. 判断优先级（P0/P1/P2）
4. 识别涉及的角色和权限
```
### 步骤 2：收集项目上下文
```markdown
1. 扫描项目目录结构
2. 识别技术栈（语言、框架、数据库）
3. 识别现有可复用模块
4. 记录依赖关系
```
### 步骤 3：识别约束条件
```markdown
1. 技术约束（性能、安全、兼容性）
2. 业务约束（法规、行业标准）
3. 时间约束（上线时间、里程碑）
4. 资源约束（团队规模、预算）
```
### 步骤 4：生成分析报告（必须实际写入文件）
**重要：产物必须保存到文件，不能只在对话中展示！**
**写入步骤**：
1. 按模板生成完整的分析报告内容
2. 执行：write {项目路径}/.agent/harness/_analysis.md
3. 验证：执行 read {项目路径}/.agent/harness/_analysis.md 确认写入成功
4. 如果写入失败 → 重试 → 直到成功
**阻断规则**：如果 _analysis.md 未实际写入文件 → 不能进入 CONFIRM 阶段
---
## 5. 输出格式
### 5.1 产物文件
{项目路径}/.agent/harness/_analysis.md
### 5.2 模板参考
产物模板定义请参考 [artifacts/template-artifacts.md](../artifacts/template-artifacts.md) 中对应的分析报告模板。
**关键结构要求**：
- 标题层级：`# 需求分析报告` → `## 基本信息` → `###` 细分
- 核心功能使用表格格式（功能点、优先级、说明）
- 风险评估包含风险等级和缓解措施
---
## 6. 验证标准
### 6.1 格式检查（自检清单）
```markdown
检查清单：
- [ ] 标题正确（# 需求分析报告）
- [ ] 基本信息完整（时间、分析者、场景类型）
- [ ] 核心功能列表完整
- [ ] 技术栈识别准确
- [ ] 涉及文件列表准确
- [ ] 约束条件清晰
```
### 6.2 内容检查（自检清单）
```markdown
检查清单：
- [ ] 功能点覆盖完整
- [ ] 优先级排序合理
- [ ] 技术栈选择合理
- [ ] 可复用资源识别准确
- [ ] 风险评估合理
```
### 6.3 阻断条件
```markdown
如果自检清单中有未勾选项：
→ 停止执行
→ 输出错误："ANALYZE 产物不完整，缺少：[具体缺失项]"
→ 补充缺失内容后重新自检
```
---
## 7. 错误处理
### 7.1 项目不存在
```markdown
如果项目路径不存在：
1. 创建目录结构
2. 记录警告
3. 继续分析（基于用户需求）
```
### 7.2 技术栈无法识别
```markdown
如果无法识别技术栈：
1. 使用默认值（Python + Flask）
2. 在报告中标注"需确认"
3. 提示用户补充
```
---
## 8. 质量审核触发
> 产物生成后，必须触发独立质量审核。
```markdown
## 产物完成后的强制操作
- [ ] 1. _analysis.md 已写入文件系统
- [ ] 2Github ReposUpdated 10h agoRank 70
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
OPENCLAW
Github ReposUpdated 6mo agoRank 70
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
OPENCLAW
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/songzhou666/skills/reqplan-v3",
"sourceUrl": "https://clawhub.ai/songzhou666/skills/reqplan-v3",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T15:33:07.357Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-songzhou666-reqplan-v3/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-songzhou666-reqplan-v3/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T15:33:07.357Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "2.4K downloads",
"href": "https://clawhub.ai/songzhou666/reqplan-v3",
"sourceUrl": "https://clawhub.ai/songzhou666/reqplan-v3",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T15:33:07.357Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.1.0",
"href": "https://clawhub.ai/songzhou666/reqplan-v3",
"sourceUrl": "https://clawhub.ai/songzhou666/reqplan-v3",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-06T09:34:47.785Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-songzhou666-reqplan-v3/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-songzhou666-reqplan-v3/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.1.0",
"description": "ReqPlan-v3 0.1.0 — Initial release - Introduces a project lifecycle management engine for systematic execution of software engineering tasks. - Enforces a strict state machine workflow (START → ANALYZE → CONFIRM → DESIGN → IMPLEMENT → VERIFY → JUDGE). - Implements a mandatory entry checklist and first-response guard to ensure process rigor. - Defines clear rules on when to activate, file structure for artifacts, and strict security and privacy controls. - Incorporates a user interruption handling mechanism with smart resume, reset, or TODO logic. - Requires all outputs and transitions to be tracked via baton files; prohibits oral transmission or workflow bypass.",
"href": "https://clawhub.ai/songzhou666/reqplan-v3",
"sourceUrl": "https://clawhub.ai/songzhou666/reqplan-v3",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-06T09:34:47.785Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.