用途:该技能用于 SpecRail 的 write_spec 流程中的技术规格编写环节,为某个关联 issue 产出编号的 tech.md 技术规格文件,也可用于更新已有规格。
主要能力:先读取关联 issue 与 specs/GH<issue-number>/product.md,再读取 templates/<locale>/tech_spec.md 或 templates/tech_spec.md 中对应语言的模板。在可用时运行本地门禁:python3 checks/route_gate.py --repo . --route write_spec --issue <issue-number> --state ready_to_spec --json,随后写入 specs/GH<issue-number>/tech.md。规格需结合代码库上下文,说明相关文件、当前行为以及各区域变更或保持不变的原因;把每条产品行为不变量映射到实现区域与验证方式;并描述设计方案、数据流、涉及组件、边界情况、迁移或兼容性风险、验证计划与回滚计划,同时给出证明设计已落地的确定性检查。
使用方式:按上述步骤顺序执行,使用本地化模板与门禁命令,产出指定路径的规格文件。
限制:不要在技术规格步骤就开始实现;不要声称规格已获批准,缺少批准应作为人工门禁报告;自动化需保持 dry-run 与建议性默认行为;面向机器的稳定 ID 需保持英文。费用、平台与效果等资料暂未提供。