用途:在 SkillHone 优化技能前,先明确目标(Goal)、运行环境(Environment,含工具)与评测方式(Evaluation,含输出格式与评分标准),把技能 PRD 写成评测契约而非功能清单。
主要能力:通过 AskUserQuestion 工具进行多轮交互访谈,逐维度提问并记录问答;按固定顺序生成 PRD 章节(## 1. Environment → ## 2. Goal → ## 3. Output format → ## 4. Evaluation);输出三个文件到评测仓库根目录:PRD.md(含评测标准,仅评测智能体可见)、PRD.improver_only.md(去掉第 4 节评测,供改进/迭代智能体看)、PRD.choice.md(完整问答记录,评测工件)。
使用方式:问题每轮 2–4 个选项、header 不超过 12 字符;每问只做一项决策;尽量在首轮覆盖四个维度,后续轮次追问依赖项;从第 2 轮起加入 Stop? 问题,仅用户明确表示停止时才结束。写入命令示例:python3 scripts/write_prd.py --skill-name <skill> --data collected_prd.json --out-dir <skill-eval-dir> --eval-wiki-dir <checked-out-skill-eval-wiki> --skill-wiki-dir <checked-out-skill-wiki>,随后用 scripts/validate_prd.py 校验。文件写入位置按用户指定目录、同级 <skill-name>-eval、$SKILLHONE_EVAL_DIR 或当前目录顺序检测。
适用场景:构建或优化智能体技能前需要明确目标、工具与评测口径时;需要把评测标准与改进方隔离以避免 Goodhart 效应时。
限制:仓库只写文件,不自动 git commit/push;评测标准、验证器、评测数据集细节不得发布到技能 wiki;PRD.improver_only.md 由脚本生成,不应手改;PRD.choice.md 只能进评测 wiki;Forgejo wiki 页面名区分大小写且用连字符(如 PRD-Choices.md)。若访谈中途停止且维度未确定,PRD 中会标注为暂未确定,不做猜测。