核心概述
Stellar Trails 是一个面向LLM代理的六阶段工作流执行框架（IDLE → SPECIFY → PLAN → IMPLEMENT → VERIFY → DELIVER），通过三层强制机制（E1阶段机器、E2强制打印、E3偏好对话）将任务执行从"依赖模型善意"转变为"可验证的工件产出"。
核心用法
阶段机器（E1）
每个任务强制通过六个阶段，不允许跳过。阶段入口打印 📍 ENTER <PHASE>，出口打印 📍 EXIT <PHASE> → <NEXT>，交付报告的Phase Trace字段必须列出所有标记对。缺失标记即视为合规缺陷。
强制打印（E2）
三种打印为强制性输出，作为工作流运行的唯一可靠信号：
- 激活横幅：会话首条输出，含版本、复杂度层级、任务类型
- COMMIT块（Standard/Complex）：PLAN阶段结束时输出，包含方案、替代方案、回退策略、范围边界
- 交付报告：会话末输出，汇总所有阶段执行结果
偏好对话（E3）
任何涉及受众/风格/长度/格式的决策点，必须通过AskUserQuestion获取用户确认，禁止模型猜测。适用场景包括文档/可视化/PPT等交付物创建、中期范围决策、Pivot后的恢复决策。跳过条件需显式声明。
复杂度自适应
| 层级 | 标准 | 报告格式 |
|------|------|---------|
| Minimal | 纯知识问答，无代码/文件输出 | `☄️ PASS \| Evidence: ...` |
| Simple | 单文件，无架构变更 | `☄️ REPORT [Simple]` 单行 |
| Standard | 多文件或架构变更 | `☄️ REPORT [Standard]` 完整块 + Traceability ID |
| Complex | 架构级变更、多服务、高风险 | `☄️ REPORT [Complex]` 扩展证据 + SADC子代理 |
来源可用性与文档检查（SADC）
Standard/Complex任务必须在编写问题规格前，委托子代理进行网络搜索和文档爬取，确保方案基于真实来源而非假设。未找到现有解决方案需显式声明。
Pivot机制
错误分类为"Bug"或"Wrong Approach"。后者（需50%+重写、同一错误两次、缺失库特性、数据模型变更）触发Pivot：回退到PLAN阶段，评估替代方案，通过E3获取用户确认后重新实施。
显著优点
1. 可追溯性：每个实现步骤分配Traceability ID（IMPL-001等），支持从需求到验证的完整链路
2. 抗截断设计：激活横幅每次都打印（不依赖"已打印过"记忆），worklog.md快照支持上下文丢失后的状态恢复
3. 范围控制：显式的Scope IN/OUT边界和Scope Drift追踪，防止范围蔓延
4. 质量门控：PLAN→IMPLEMENT需用户批准，VERIFY→DELIVER需所有检查通过
5. 错误处理结构化：Incident Report模板强制根因分析至2+层级深度，Pivot决策树避免反复试错
潜在缺点与局限性
1. 执行开销：Minimal任务仍需完整六阶段（内部运行），频繁简单任务可能显得繁琐
2. LLM依赖本质：三层强制仍为文本级规则，模型可通过"合理化"绕过；作者承认70-85%的SOTA模型合规天花板，v9.0.0设计目标为~90%
3. 无平台级强制：100%合规需ClawHub级别的调用拦截，技能文件本身无法实现
4. 子代理延迟：SADC和偏好对话增加网络调用延迟，实时性敏感场景可能不适用
5. 模板刚性：Standard/Complex必须使用精确模板，"自由格式"被视为正确性缺陷，灵活性受限
适合人群
- AI代理开发者：需要可审计、可复现的复杂任务执行框架
- 企业自动化团队：对LLM输出有合规和可追溯要求的场景
- 多步骤工作流用户：编码、文档生成、数据处理、可视化等需分解执行的任务
- 质量敏感场景：架构变更、生产代码修改、高风险的自动化决策
常规风险
1. 合规幻觉：模型可能伪造阶段标记或打印检查，用户需人工验证交付报告
2. 范围承诺失效：COMMIT块后的用户变更可能未触发重新规划，需警惕"隐性范围漂移"
3. 子代理失败：SADC子代理网络搜索失败时，框架可能基于不完整信息继续
4. Git操作风险：虽有显式规则（禁止rebase/reset/force push），但基础设施级git阻塞仍需人工介入
5. 自动更新风险：Step 3的clawhub update --force可能引入未经审查的技能变更
版本演进
v9.0.0为重大更新，将三层强制机制从"建议性 prose"升级为"可验证工件"，新增inline模板（原procedure/templates/迁移至文档内），强化SADC和AskUserQuestion的执行可见性。