核心用法
Stellar Trails 是一个通用的六阶段工作流框架（IDLE → SPECIFY → PLAN → IMPLEMENT → VERIFY → DELIVER），通过严格的阶段门控和可追溯性机制，将任意任务转化为可审计、可恢复的标准化流程。
激活机制：每次 Skill 调用强制打印激活横幅，执行 5 步初始化（上下文刷新、弹出服务器、自动更新、文件验证、阶段加载），确保版本一致性和环境就绪。
复杂度自适应：
- Minimal 层级：非编码任务（问答、解释），阶段内部运行，仅输出单行
☄️ PASS - Simple 层级：轻量任务，简化仪式，输出
☄️ REPORT [Simple] - Standard/Complex 层级：完整六阶段，包含 SADC（源码可用性与文档检查）、AskUserQuestion 门控、子代理委托、Scope 承诺与 Delivery 报告
关键特性：
- Traceability IDs：每个实现步骤标记 IMPL-XXX，确保需求到代码的完整追溯
- Session Continuity：通过
worklog.md快照实现上下文截断后的精确恢复，避免重复规划 - Pivot 机制：错误分类为 Bug 或 Wrong Approach，后者触发方案回退与重新规划
- SADC 子代理：Standard/Complex 任务自动委托研究现有方案与官方文档，避免重复造轮子
适用范围：
- 编码任务（功能开发、Bug 修复、重构、脚本）—— 完整六阶段
- 文档任务（报告、提案、DOCX/PDF）—— AskUserQuestion 确认受众/风格/长度
- 可视化（图表、仪表盘）—— 数据映射与视觉验证
- 数据处理（ETL、分析）—— 转换管道与输出校验
- Web 开发（Next.js/UI）—— 委托给 fullstack-dev，本框架包装工作流
交付物：
- Standard/Complex：
☄️ COMMIT [Standard]范围承诺 +☄️ REPORT [Standard]结构化报告 - Simple：
☄️ REPORT [Simple]单行摘要 - Minimal：
☄️ PASS单行结果
显著优点
1. 确定性输出：强制的首尾输出（激活横幅 + 交付报告）消除用户对工作流状态的猜测
2. 版本一致性：每次调用从磁盘重读 SKILL.md，ClawHub 自动更新，避免缓存版本错乱
3. 抗截断恢复：worklog 快照协议使长会话在上下文压缩后仍能精确续接
4. 专业级可追溯：IMPL-XXX 编号与 Scope/Drift 字段满足审计与复盘需求
5. 智能委托：Standard/Complex 任务自动拆分 SADC 研究给子代理，主代理专注问题解决
潜在缺点与局限性
1. 仪式开销：Minimal 任务仍需打印横幅和 PASS 行，对真正简单的问答可能显得冗余
2. 子代理依赖：SADC 委托需要 web-search、crawl4ai/web-reader 等技能可用，基础设施缺失时降级为内联研究
3. 自评局限：QA Attestation 为自评，虽降低幻觉概率，但无法替代独立验证
4. Git 假设：SSV（源状态验证）步骤假设 Git 环境可用，纯本地或非 Git 项目需跳过
5. 弹出服务器：dev.sh 启动依赖本地端口 3000，冲突时需手动处理
适合人群
- 企业开发团队：需要标准化代码审查、变更追溯与交付文档
- 长期项目维护者：Session Continuity 机制解决多轮对话中的上下文丢失痛点
- 多任务并行场景：复杂度分级与阶段门控防止简单任务被过度流程化
- LLM 工作流研究者：六阶段模型可作为 Agent 编排的参考实现
常规风险
| 风险场景 | 缓解措施 |
|---------|---------|
| 跳过激活横幅 | 文档明确标注"non-negotiable"，但依赖 LLM 遵循指令 |
| 版本漂移（ClawHub 更新后缓存未刷新） | Step 1 强制磁盘重读，Step 3 更新后二次重读 |
| 上下文截断后重复规划 | worklog.md 快照协议，但需 DELIVER 阶段正确写入 |
| 子代理研究失败 | 优雅降级为内联研究，不影响主流程 |
| Scope 承诺与实际交付不符 | Scope Drift 字段强制记录，Pivot 机制处理变更 |