[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75MKRVCW4KXG232P7F07ZGG":3,"skill-same:01M75MKRVCW4KXG232P7F07ZGG":66},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M75MKRVCW4KXG232P7F07ZGG","software-factory",null,"devcxl\u002Fmattpocock-skills-zh","devcxl","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F64475363?v=4","01M75MJ7N3BE0AK24Q83ZVY13N","半颗白菜","01M75MJ7P58635MPFAW17AG3SV",541,"MIT","https:\u002F\u002Fgithub.com\u002Fdevcxl\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fin-progress\u002Fsoftware-factory\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: software-factory\ndescription: Shared language for designing a software factory: the tasks it runs and the services it plugs into.\ndisable-model-invocation: true\n---\n\n**software factory** 是一种由 agents 组成的系统，它会把 tickets、PRs 和日程安排转化为已合并的代码，并部署到用户选择的远程基础设施上。本技能为设计 factory 提供一套语言。讨论或白板梳理 factory 时，只使用以下术语；如果用户用了 _Avoid_ 下的词，就指出对应的规范术语。\n\n## Tasks and runs\n\n**Task**：\n一种由 factory 执行的工作，只需定义一次，就可以反复运行：review、explore、implement、ratchet。Task 可以处理一个 ticket、一个 PR，或整个 codebase。\n_Avoid_：不要将 job、workflow、action 用作 Task 的名称。CI 服务商的 workflow 文件及其 jobs 是配置 task 的地方，而不是 task 本身。\n\n**Trigger**：\n启动一个 run 的事件：ticket tracker 或 git host 中的变更、orchestrator 上的时钟，或另一个 run。\n\n**Run**：\n一个 task 在一个 runner 上从触发到结束的一次执行，作为黑盒处理。一个 run 可以直接触发后续 runs、通过 orchestrator 中的逻辑触发，也可以通过更改 ticket tracker 或 git host 触发。run 绝不会等待人类：它会结束，而人类之后对 ticket tracker 或 git host 所做的更改会触发一个新的 run。\n_Avoid_：session\n\n**Runner**：\nrun 执行所用的一次性机器。即使机器本身长期运行，run 结束后其上的任何内容都不会保留：run 对先前 runs 的唯一记忆，就是 ticket tracker、git host 和 orchestrator。\n_Avoid_：server、host、box、compute、sandbox\n\n## Services\n\n**Ticket tracker**：\ntickets 所在的位置，也是 factory 面向人的接口：人类通过提交 tickets 来安排工作，在 ticket 评论中与 agents 交流，而他们对 tickets 的更改会触发 runs。\n_Avoid_：issue tracker、ticket manager、project board\n\n**Ticket source**：\nfactory 之外任何能在 ticket tracker 中创建 tickets 的事物：feedback button、monitor、error tracker、inbox。\n_Avoid_：data source、trigger source、intake\n\n**Git host**：\nbranches、PRs 和 reviews 所在的位置。\n_Avoid_：code host、forge、repo\n\n**Orchestrator**：\n接收 triggers、在 runners 上启动 runs，并记录哪些 runs 正在排队、执行中或已完成的组件。\n_Avoid_：dispatcher、scheduler、control plane\n\n**Observability platform**：\nrunners 发送 logs、traces 和 status 的地方，让人类能够看到每个 run 内部发生了什么。它是可选的：填入 runner 或 orchestrator 槽位的产品往往本身就能提供足够的信息。在有内容被写入 ticket tracker 或 git host 之前，run 绝不会据此作出决定。\n_Avoid_：observability、logs、monitoring、dashboard\n\n## 设计 factory\n\n设计分为两部分：**services**，每个 slot 由一款 product 填充；以及推动工作在这些服务间流转的 **tasks**。\n\n从用户的问题出发，而不是先从 factory 出发：尚未 triage 的 tickets、等待 automated review 的 PRs、需要迁移到更严格 automated check 的情况，以及无人查看的 bugs。当用户指出问题，或不知道要构建什么时，阅读 [EXAMPLE-TASKS.md](EXAMPLE-TASKS.md)，了解解决常见问题的 tasks。\n\n### 从慢开始\n\n每个 Trigger 都是一个加速器。没有刹车的加速器会变成一门 slop cannon（低质产出炮）。刹车有三种：\n\n- **Automated checks**：确定性门禁（types、lint、tests），每个 run 都必须通过。\n- **Automated review**：单独启动一个 run，以全新视角对照 codebase 的标准和对应 ticket（如果有）检查 diff。\n- **Human review**：PR 合并前由人类阅读；它发现的问题会转化为新的 automated checks，并让 automated review 更精准。\n\n每次只增加一个 automated trigger，起初先限流（十条 bug report 中触发一条，或每天按时触发一次），并确保每个 PR 都经过 human review。随着刹车逐渐赢得信任，再放宽限流；每个 runs 循环都应限制在几次尝试之内，然后交由人类处理。\n\n### 填满每个 slot\n\n每项 service 都是一个 slot。一款 product 可以填充多个 slots，一台 server 也可以托管多项 services。以下是三种并列设计：\n\n| Service                | All on GitHub                   | Linear tickets                 | Own tracker              |\n| ---------------------- | ------------------------------- | ------------------------------ | ------------------------ |\n| Ticket tracker         | GitHub Issues                   | Linear                         | own app                  |\n| Ticket source          | feedback button                 | feedback button, monitor       | feedback button, monitor |\n| Git host               | GitHub                          | GitHub                         | GitHub                   |\n| Orchestrator           | GitHub Actions                  | own server + database          | own app                  |\n| Runner                 | Actions runner                  | Actions, E2B, Daytona or a VPS | own app, or sandboxes    |\n| Observability platform | none: Actions run pages suffice | an LLM tracing platform        | own app                  |\n\n用户为某个 slot 选择 product 时，先阅读该 slot 的调研文档以了解概况，然后自行调查当前有哪些选项；每份调研文档都会按类型归纳选项，并列出决定该 slot 时需要回答的问题：\n\n- [TICKET-TRACKERS.md](TICKET-TRACKERS.md)\n- [GIT-HOSTS.md](GIT-HOSTS.md)\n- [RUNNERS.md](RUNNERS.md)\n- [OBSERVABILITY-PLATFORMS.md](OBSERVABILITY-PLATFORMS.md)\n\n服务可以购买，tasks 则由你来构建：tasks 承载用户的设计，services 则是通用的。优先选择现成的 ticket tracker：它可靠耐用，人们已经熟悉，而且很容易让外部用户加入。\n\n### 逐一审视每个 task\n\n对每个 task，回答：\n\n1. 是什么触发了它？\n2. 它会做什么，又会读取和写入哪些 services？\n3. 它接下来会触发什么？\n4. 人类会在什么环节重新介入？\n5. 如何避免两个 runs 重复做同一项工作？\n\n对每个 ticket source，回答：怎样避免它重复提交同一个 ticket？\n\n当每个 slot 都指定了一款 product（或者，为 observability platform 有意选择 none），并且每个 task 和 ticket source 对每个问题都有答案时，设计才算完成。\n","**software factory** 是一种由 agents 组成的系统，它会把 tickets、PRs 和日程安排转化为已合并的代码，并部署到用户选择的远程基础设施上。本技能为设计 factory 提供一套语言。讨论或白板梳理 factory 时，只使用以下术语；如果用户用了 _Avoid_ 下的词，就指出对应的规范术语。\n\n## Tasks and runs\n\n**Task**：\n一种由 factory 执行的工作，只需定义一次，就可以反复运行：review、explore、implement、ratchet。Task 可以处理一个 ticket、一个 PR，或整个 codebase。\n_Avoid_：不要将 job、workflow、action 用作 Task 的名称。CI 服务商的 workflow 文件及其 jobs 是配置 task 的地方，而不是 task 本身。\n\n**Trigger**：\n启动一个 run 的事件：ticket tracker 或 git host 中的变更、orchestrator 上的时钟，或另一个 run。\n\n**Run**：\n一个 task 在一个 runner 上从触发到结束的一次执行，作为黑盒处理。一个 run 可以直接触发后续 runs、通过 orchestrator 中的逻辑触发，也可以通过更改 ticket tracker 或 git host 触发。run 绝不会等待人类：它会结束，而人类之后对 ticket tracker 或 git host 所做的更改会触发一个新的 run。\n_Avoid_：session\n\n**Runner**：\nrun 执行所用的一次性机器。即使机器本身长期运行，run 结束后其上的任何内容都不会保留：run 对先前 runs 的唯一记忆，就是 ticket tracker、git host 和 orchestrator。\n_Avoid_：server、host、box、compute、sandbox\n\n## Services\n\n**Ticket tracker**：\ntickets 所在的位置，也是 factory 面向人的接口：人类通过提交 tickets 来安排工作，在 ticket 评论中与 agents 交流，而他们对 tickets 的更改会触发 runs。\n_Avoid_：issue tracker、ticket manager、project board\n\n**Ticket source**：\nfactory 之外任何能在 ticket tracker 中创建 tickets 的事物：feedback button、monitor、error tracker、inbox。\n_Avoid_：data source、trigger source、intake\n\n**Git host**：\nbranches、PRs 和 reviews 所在的位置。\n_Avoid_：code host、forge、repo\n\n**Orchestrator**：\n接收 triggers、在 runners 上启动 runs，并记录哪些 runs 正在排队、执行中或已完成的组件。\n_Avoid_：dispatcher、scheduler、control plane\n\n**Observability platform**：\nrunners 发送 logs、traces 和 status 的地方，让人类能够看到每个 run 内部发生了什么。它是可选的：填入 runner 或 orchestrator 槽位的产品往往本身就能提供足够的信息。在有内容被写入 ticket tracker 或 git host 之前，run 绝不会据此作出决定。\n_Avoid_：observability、logs、monitoring、dashboard\n\n## 设计 factory\n\n设计分为两部分：**services**，每个 slot 由一款 product 填充；以及推动工作在这些服务间流转的 **tasks**。\n\n从用户的问题出发，而不是先从 factory 出发：尚未 triage 的 tickets、等待 automated review 的 PRs、需要迁移到更严格 automated check 的情况，以及无人查看的 bugs。当用户指出问题，或不知道要构建什么时，阅读 [EXAMPLE-TASKS.md](EXAMPLE-TASKS.md)，了解解决常见问题的 tasks。\n\n### 从慢开始\n\n每个 Trigger 都是一个加速器。没有刹车的加速器会变成一门 slop cannon（低质产出炮）。刹车有三种：\n\n- **Automated checks**：确定性门禁（types、lint、tests），每个 run 都必须通过。\n- **Automated review**：单独启动一个 run，以全新视角对照 codebase 的标准和对应 ticket（如果有）检查 diff。\n- **Human review**：PR 合并前由人类阅读；它发现的问题会转化为新的 automated checks，并让 automated review 更精准。\n\n每次只增加一个 automated trigger，起初先限流（十条 bug report 中触发一条，或每天按时触发一次），并确保每个 PR 都经过 human review。随着刹车逐渐赢得信任，再放宽限流；每个 runs 循环都应限制在几次尝试之内，然后交由人类处理。\n\n### 填满每个 slot\n\n每项 service 都是一个 slot。一款 product 可以填充多个 slots，一台 server 也可以托管多项 services。以下是三种并列设计：\n\n| Service                | All on GitHub                   | Linear tickets                 | Own tracker              |\n| ---------------------- | ------------------------------- | ------------------------------ | ------------------------ |\n| Ticket tracker         | GitHub Issues                   | Linear                         | own app                  |\n| Ticket source          | feedback button                 | feedback button, monitor       | feedback button, monitor |\n| Git host               | GitHub                          | GitHub                         | GitHub                   |\n| Orchestrator           | GitHub Actions                  | own server + database          | own app                  |\n| Runner                 | Actions runner                  | Actions, E2B, Daytona or a VPS | own app, or sandboxes    |\n| Observability platform | none: Actions run pages suffice | an LLM tracing platform        | own app                  |\n\n用户为某个 slot 选择 product 时，先阅读该 slot 的调研文档以了解概况，然后自行调查当前有哪些选项；每份调研文档都会按类型归纳选项，并列出决定该 slot 时需要回答的问题：\n\n- [TICKET-TRACKERS.md](TICKET-TRACKERS.md)\n- [GIT-HOSTS.md](GIT-HOSTS.md)\n- [RUNNERS.md](RUNNERS.md)\n- [OBSERVABILITY-PLATFORMS.md](OBSERVABILITY-PLATFORMS.md)\n\n服务可以购买，tasks 则由你来构建：tasks 承载用户的设计，services 则是通用的。优先选择现成的 ticket tracker：它可靠耐用，人们已经熟悉，而且很容易让外部用户加入。\n\n### 逐一审视每个 task\n\n对每个 task，回答：\n\n1. 是什么触发了它？\n2. 它会做什么，又会读取和写入哪些 services？\n3. 它接下来会触发什么？\n4. 人类会在什么环节重新介入？\n5. 如何避免两个 runs 重复做同一项工作？\n\n对每个 ticket source，回答：怎样避免它重复提交同一个 ticket？\n\n当每个 slot 都指定了一款 product（或者，为 observability platform 有意选择 none），并且每个 task 和 ticket source 对每个问题都有答案时，设计才算完成。\n",{},"main","df81bd77fb87e86b964108294ff2a02ddc14016e","skills\u002Fin-progress\u002Fsoftware-factory",48,"https:\u002F\u002Fgithub.com\u002Fdevcxl\u002Fmattpocock-skills-zh","https:\u002F\u002Fgithub.com\u002Fdevcxl","2026-11-13 04:10:40",{"source":7,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add devcxl\u002Fmattpocock-skills-zh --skill software-factory",{"tool":36,"command":37},"bunx","bunx skills add devcxl\u002Fmattpocock-skills-zh --skill software-factory",{"tool":39,"command":40},"pnpm","pnpm dlx skills add devcxl\u002Fmattpocock-skills-zh --skill software-factory","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevcxl\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fin-progress\u002Fsoftware-factory\u002FSKILL.md",true,[44,50,54,58,62],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},"EXAMPLE-TASKS.md","REFERENCE","参考文档",4331,"https:\u002F\u002Fgithub.com\u002Fdevcxl\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fin-progress\u002Fsoftware-factory\u002FEXAMPLE-TASKS.md",{"path":51,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":52,"sourceHtmlUrl":53},"GIT-HOSTS.md",8349,"https:\u002F\u002Fgithub.com\u002Fdevcxl\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fin-progress\u002Fsoftware-factory\u002FGIT-HOSTS.md",{"path":55,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":56,"sourceHtmlUrl":57},"OBSERVABILITY-PLATFORMS.md",8359,"https:\u002F\u002Fgithub.com\u002Fdevcxl\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fin-progress\u002Fsoftware-factory\u002FOBSERVABILITY-PLATFORMS.md",{"path":59,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":60,"sourceHtmlUrl":61},"RUNNERS.md",9507,"https:\u002F\u002Fgithub.com\u002Fdevcxl\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fin-progress\u002Fsoftware-factory\u002FRUNNERS.md",{"path":63,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":64,"sourceHtmlUrl":65},"TICKET-TRACKERS.md",9132,"https:\u002F\u002Fgithub.com\u002Fdevcxl\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fin-progress\u002Fsoftware-factory\u002FTICKET-TRACKERS.md",[67,74,81,88,95,102],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M75MMJXWKRN5DFAYWKNHCG28","writing-for-agents","为智能体编写文档。当你正在创建或编辑技能，或者修改 AGENTS.md \u002F CLAUDE.md 时使用。","https:\u002F\u002Fgithub.com\u002Fdevcxl\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":18},"01M75MMHVFN4B6QBPNGQ5GJSDT","wait-what","等等。上一条消息我没理解：重新解释一下。","https:\u002F\u002Fgithub.com\u002Fdevcxl\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwait-what\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":18},"01M75MMGNH9G1M7WC7NKP6100Y","to-questionnaire","将你无法完全回答的决策转化为供他人填写的问卷。","https:\u002F\u002Fgithub.com\u002Fdevcxl\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fto-questionnaire\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":18},"01M75MME5PC8MBS7M6R6RH7VDH","teach","在当前工作区中教会用户一项新技能或概念。","https:\u002F\u002Fgithub.com\u002Fdevcxl\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fteach\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":18},"01M75MMD05VWVMK55W6GEWJNX3","handoff","将当前对话压缩为一份交接文档，供另一个智能体继续工作。","https:\u002F\u002Fgithub.com\u002Fdevcxl\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fhandoff\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":18},"01M75MMBS30DRYPMC6SADZ7ZTT","grilling","对用户的计划、决策或想法进行层层盘问。当用户想要压力测试自己的思考，或使用任何 'grill' 触发短语时使用。","https:\u002F\u002Fgithub.com\u002Fdevcxl\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fgrilling\u002FSKILL.md",[],[]]