steering-specs-generator

Steering Specs Generator 是一个强大的工具，旨在弥合人类专业知识与机器可读文档之间的差距。它擅长捕捉开发团队中常见的、通常未被明文记载的隐性工程知识。通过执行结构化、具备情境意识的访谈，此代理程序能提取关键的领域与架构见解——范围涵盖设计不变量 (design invariants)、业务合约到代码库拓扑——并将其转换为高质量、可执行的文档，即所谓的「指导规范」(steerings)。专为架构师、技术主管与团队领导者设计，确保团队独特的实务、约定与质量标准被条理化，供人类开发者与未来的 AI 代理程序准确遵循。

• 通过智慧存储库扫描，自动发现现有的项目约定、README 文件与架构文档。
• 提供八种不同的访谈套件，涵盖代码库拓扑、业务领域合约、安全性、测试策略等面向。
• 支持自订主题，让团队能记录特定的、利基的作业流程或内部函数库限制。
• 具备互动式与快速模式访谈功能，以适应不同程度的使用者参与度与时间限制。
• 产出标准化、Markdown 格式的输出，遵循「意图 (Intent)-规则 (Rules)-实践 (Practices)-元数据 (Meta)」结构，确保最大清晰度。
• 智慧工作阶段管理，允许使用者在多次工作间隔中暂停、储存并恢复知识提取工作阶段。

使用场景包括需要记录团队约定时，或新成员需要快速熟悉现有实务时。对于建立一致的架构分层、依赖管理规则与质量保证流程特别有效。此工具需要具备类似 AskUserQuestion 的标准 IO 工具与任务执行能力。初始化时，代理程序会扫描现有的 .sessions/ 文件夹以自动侦测先前的作业。产生的指导规范应储存于如 ./steerings/ 或 .memory-bank/ 等专用位置，以利与其他开发者工作流程顺畅整合。使用者应将输出保持在存储库结构内，确保产生的知识库能随实际代码同步演进，成为工程最佳实践、安全性要求与历史技术债的实时维护文档。