用途:tech-brief 用于开发完成后的技术分享与知识传递,把实现发现整理成面向技术同事的简报。不适用于面向 PM/CTO 的高层摘要、第一性原理推理、设计阶段规格或函数级代码解释。
主要能力:命令签名为 /tech-brief [<feature-key>|<docs-path>] [--depth brief|normal|deep] [--output <path>] [--no-save]。工作流分四阶段:上下文解析(用 node scripts/resolve-feature.js 解析特性,5 级级联)、多源收集(读设计文档、git log -20 与 git diff --stat 并读前 5 个变更源文件各 100 行、按日期取最多 3 个请求文档)、综合(生成来源溯源表并按深度过滤)、输出。深度分 brief(约 500 词)、normal(约 1500 词)、deep(约 3000 词),均为上限而非目标。输出含来源溯源表及背景与问题、设计决策与权衡、实现要点、限制与已知问题、讨论与参考、后续步骤等章节。
使用方式:默认输出到 docs/features/<key>/5-tech-brief.md;--output 指定路径(仓库外会警告);--no-save 仅打印到 stdout。无特性且无 --output 时进入 Need Human 门控。
限制:含 .. 的输入会被拒绝;读取前扫描密钥,高置信度中止、中置信度以 [REDACTED] 掩码;来源不足时输出 Evidence Insufficient 标记。具体收费、平台与效果暂未提供。