关于 software-factory
Software Factory 是一种可追踪的软件交付技能,将产品意图、技术设计与实现工作联系起来。它指导 Work Order 执行,并要求在编写记录或编码前,通过 Software Factory MCP 读取项目规则和相关 Blueprint。
主要功能
- 01连接需求、设计与交付
- 02指导 Work Order 执行
- 03按任务路由至执行指南
- 04要求遵循记录专属写作规则
- 05记录清单完成状态与跳过原因
适用场景
- 01执行仓库中的 Work Order
- 02在执行期间制定实现计划
- 03创建或更新 Factory 记录
- 04依据执行流程审查工作
MCP 相关
该技能通过 Software Factory MCP 获取项目写作规则和相关 Blueprint,并通过 MCP 查找和读取记录编写所需的技能。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ 8090-inc/ software-factory-plugin --skill software-factory安装后在 Claude Code 中输入/software-factory确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
execution/execute-work-order.mdreview.mdwriting-implementation-plans.mdexecution/scripts/checklist-template.mdcontext-template.mdimplementation-plan-template.mdinit-wo-execution.shreview-log-template.mdupdate-context-index.sh详细介绍
Software Factory
Software Factory 是一种 AI 原生 SDLC 方法,用于在一个可追溯的工作流中连接产品意图、技术意图和实施工作。
此技能帮助你有效使用 Software Factory MCP,并指导你在此仓库中可靠、可追溯地执行 Work Order。
记录
- 知识库保存项目文档和文件,例如研究资料、会议记录和设计产物。
- 需求从外部视角描述系统:系统必须为用户做什么,以及为什么。
- 蓝图从内部视角描述系统:其组件、契约和架构。
- Work Order描述交付内容:变更的可实施范围、排除项,以及它关联的需求和蓝图。
- 反馈是产品用户提交的请求和报告。
- 主题将根本原因相同的反馈项归为一组,便于一并分诊并通过一个 Work Order 处理。
记录编写
在创建或更改知识库文档、需求、蓝图、Work Order、反馈项或主题之前,通过 Software Factory MCP 阅读项目当前适用于该类记录的编写规则。调用 list_skills 查找该类记录的编写规则,然后对该技能调用 read_skill,并阅读它指向的任何子技能。严格按照这些规则编写记录。如果 Software Factory MCP 不可用,请停止并告知用户。
实施期间,编码前须通过 Software Factory MCP 阅读每个被引用的蓝图,包括 @… 提及和链接。
路由
| 任务 | 阅读 |
|---|---|
| 执行一个 Work Order | execution/execute-work-order.md |
| 执行多个 Work Order | execution/execute-work-order.md |
| 在执行期间编写实施计划 | execution/writing-implementation-plans.md |
| 执行评审 | execution/review.md |
| 初始化执行目录 | execution/scripts/init-wo-execution.sh |
| 更新执行上下文 | execution/scripts/update-context-index.sh |
| 创建或更改 Software Factory 记录 | 通过 Software Factory MCP 获取项目技能 |
Work Order 执行
每个 Work Order 都必须遵循执行流程。每个清单项都必须完成,并处于以下两种状态之一:标记为已完成 [x],或标记为 [SKIP] 并注明跳过原因。任何未勾选的项目都意味着执行失败。
对于单个 Work Order 和多个 Work Order 组成的队列,请遵循 execution/execute-work-order.md,并阅读该指南指引的 execution/ 中相关文件。执行文件记录工作如何完成;Software Factory MCP 编写规则则规范记录本身。
此清单是一份持续完善的 harness 工程产物。团队会根据代码库的实际情况不断改进它,加入能让 Agent 式编程可靠运行的具体命令、检查、截图、迁移、测试夹具、种子数据、CI 门禁和评审流程。
只有在用户或仓库工作流提出要求时,才提交、推送、创建拉取请求或合并。