用途:cs-goal 用于处理有界目标(bounded goal)。owner 给出起点和期望终态,AI 先做轻量 interview/grill,动手前写起点报告,然后自主实现、验证、迭代,直到完成或受阻。适用于如"从当前损坏状态让测试通过"、"达到指定验收结果"、"自主运行并自我迭代"、"持续尝试直到完成或受阻"、"先 grill 我,再实现"、"我只关心结果不关心技术选择"等场景。
主要能力:设有阶段化流程。开始前先执行 CodeStable preflight:读 .codestable/attention.md;缺失先 cs-onboard。阶段 1 Grill 对齐,最多问 3-5 个聚焦问题,只收集 objective、starting point、acceptance/done signal、non-goals、预算或停止偏好、本 goal 特有的 owner-stop 条件。阶段 2 创建或恢复 goal,目录为 .codestable/goals/YYYY-MM-DD-{slug}/,含 state.yaml、goal.md、functional-acceptance.md(仅在终端验收 gate 创建)和 iterations/。阶段 3 自主迭代,报告是 iteration 摘要。终端功能验收须用 fresh evidence,并按执行约定启动 Task agent,结果写入 functional-acceptance.md。状态模型沿用 active | complete | blocked,state.yaml 是机器 source of truth。
用法:先读相关 reference(reference.md、system-overview、goal-conventions、approval-conventions、execution-conventions)。检查 .codestable/goals/ 是否已有匹配 active goal,有则恢复而非新建。修改 state.yaml.current_iteration 前推导下一个三位数编号,不覆盖旧报告。只有 acceptance signal 满足、Task agent 验收 passing、证据写入 final iteration 才可标 complete;同一 blocker 至少连续三次 iteration 重复才可标 blocked。
限制:不用于纯设计、roadmap 或讨论请求,不用于 owner 未知终态的开放式 brainstorm,也不用于不要求推进到完成的状态检查或 audit。这是 goal 包装器,不替代 feature/issue/refactor 规则。Task agent 无法启动或未授权时应写 approval-report.md 并 owner-stop,不得自验收。每个 Markdown 产物须少于 300 行,过长拆分。