用途:在议题上记录叙述性上下文,例如尝试过什么、做了什么决定、遇到什么阻塞,或下一个智能体需要知道的信息。评论是议题历史的持久记忆。
适用时机:完成一个有意义的步骤后(做出决定、遇到阻塞、测试通过);暂停工作前,为下一次会话留下清晰的交接;当 forge show 显示缺少上下文而你可以补充时。
命令: forge comment <id> "<message>" forge issue comment <id> "<message>" 两者等效,后者为议题作用域形式。
用法步骤:从 forge claim 确认正在处理的议题 id;运行 forge comment <id> "<message>",内容简洁具体;引用提交 sha 或文件路径,便于日后采取行动。
示例: $ forge comment forge-142 "Selector wired in bin/forge.js; multi-id close acceptance green (commit c3bcb36)." Comment added to forge-142.
成功标准:笔记足够具体,无需重新推导上下文即可行动;决策与阻塞被记录在议题上,而不只是留在对话中。
相关技能:show,在添加新评论前先读取已有评论;recap,汇总议题累积的评论。
限制:资料未提供权限、并发、格式校验或失败处理等细节。