[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DYKPRXCGEEQ020EM3PJB6K":3,"skill-same:01M7DYKPRXCGEEQ020EM3PJB6K":46},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M7DYKPRXCGEEQ020EM3PJB6K","aaw-practices",null,"AAW 研发工作方法：从需求到交付时怎样把每一步做对——原始需求原样保留、按规模选链路、以实际成果而不是记忆判断进度、缺输入就停、已有成果当基线复用、门禁不通过原地修上游、返工前讲清影响。也给出各 AAW 技能的分工与衔接。Use when 在做 SR \u002F AR \u002F 轻量需求的设计、门禁、拆分或开发，或者不确定下一步该用哪个技能、该怎么处理门禁结论与返工时。","pi-ixel\u002FAwesome-Agent-Workflow","pi-ixel","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F70789335?v=4","01M77HSFPWSKAEM5TKCY73GD7V","P!xel","01M77HSFR1T8TCWP5KP34RKJV3",9,"MIT","https:\u002F\u002Fgithub.com\u002Fpi-ixel\u002FAwesome-Agent-Workflow\u002Fblob\u002Fmain\u002Fskills-v2\u002Faaw-practices\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: aaw-practices\nversion: \"3.0.0\"\ndescription: AAW 研发工作方法：从需求到交付时怎样把每一步做对——原始需求原样保留、按规模选链路、以实际成果而不是记忆判断进度、缺输入就停、已有成果当基线复用、门禁不通过原地修上游、返工前讲清影响。也给出各 AAW 技能的分工与衔接。Use when 在做 SR \u002F AR \u002F 轻量需求的设计、门禁、拆分或开发，或者不确定下一步该用哪个技能、该怎么处理门禁结论与返工时。\n---\n\n# AAW 工作方法\n\n本技能不驱动任何流程，也不依赖任何命令行工具。它说明在 AAW 的研发链路里怎样把事情做对；具体每一步怎么做，见各自的技能。流程由谁推进（工作流引擎、用户本人）都适用。\n\n## 一、需求先立住\n\n- **原始需求原样保存**。用户明确作为需求提供的文本保持原文：不总结、不改写、不做设计性加工；分布在多段时按原顺序完整保存。普通讨论、Agent 的解释和设计推导不得混入。\n- **保存后回显核对**。把保存下来的原文回显给用户（较长时回显开头若干行并注明总行数），请用户确认一致。用户指出不一致时，先修正原文、重新核对，再继续往下做。\n- **拿不准就问**。无法判断用户是否已经提供了原始需求时，先向用户收集，不得以空内容或臆造内容开始设计。\n- 原始需求是后续设计与门禁的权威对照；任何步骤都不得修改或覆盖它。\n\n## 二、按规模选链路\n\n| 链路 | 适用 | 主要成果物 |\n|---|---|---|\n| 完整链路（从 SR 开始） | 多人协作、复杂度高、需要分阶段留痕评审的需求 | SR 设计 → AR 拆分 → 每个 AR 的范围、模块边界、ASIS \u002F TOBE 详细设计、测试设计、模块门禁 → 任务计划与逐任务开发 |\n| 从单个 AR 开始 | 已有 SR 设计和架构基线，只推进其中一个 AR | AR 范围文档起，后同完整链路 |\n| 轻量链路 | 一个人能独立设计并实现、无需多角色交接的需求 | `dev-design.md`、`test-design.md`、轻量门禁报告、`tasks-overview.md` |\n\n判断标准是需求规模，不是赶时间。轻量链路把功能设计、模块边界与详细设计合成一份口径统一的文档，面向贯穿设计到开发的同一个人；如果团队要求这些阶段分开评审，就走完整链路。\n\n## 三、做每一步时\n\n- **以实际成果判断进度，不靠记忆**。上下文压缩、会话恢复或换人接手后，重新读取已有的文档、门禁报告和任务执行记录，从实际状态继续。\n- **必需输入缺失就停**。设计依据、门禁结论、架构基线等必需输入不存在或不可读时，说清缺什么、为什么需要，不要用推断或记忆补位。\n- **已有成果当基线**。当前步骤的输出文件已存在时，仍按当前要求完整执行：先读取并评估，复用仍有效的信息和已确认的答案，只问当前确实无法确定的问题，可局部修改或整体重写，写回原位置。\n- **不编造**。代码能回答的问题先查代码，并在提问时说明查过什么；代码证不出、需要拍板的事交给用户决定，不默认采纳自己的推荐。\n- **文档放在约定位置**。调用方指定了位置就用它；没有指定时用各技能里写的默认布局，同一需求的文档放在一起，并告诉用户放在哪里。\n- **项目架构基线**是 `.sdd\u002Fsoftware_architecture.md`（由 `repo-init` 生成和维护）。模块边界以它为准，缺失时按各技能的降级口径处理并明确记录。\n\n## 四、门禁与返工\n\n- **门禁是准入，不是直通**。每一轮门禁都要生成或更新门禁报告，通过、不通过、阻塞都一样；不允许只在会话里口头给结论。\n- **不通过就原地修上游**。结论为不通过或阻塞时，不要推进下游；默认修正对应的上游成果物后重新执行门禁：SR 设计门禁修 `SR-design.md`，模块设计门禁修 ASIS \u002F TOBE \u002F 测试设计，轻量门禁修 `dev-design.md` 或 `test-design.md`。\n- **复检要全量**。保留上一轮的问题编号，逐项给出关闭、转非阻断或仍阻断的状态；复检仍做全量检查，不只看历史问题。\n- **不擅自回退**。只有用户明确要求重走上游步骤时才返工。返工前先讲清：退回到哪一步、哪些下游成果会失效、涉及哪些文件；再请用户选择「保留已有成果，在其基础上返工」还是「丢弃这些成果，从有效的上游输入重做」。\n- **关键边界要用户点头**。进入实现之前（任务计划确认）、正式基线确认之类的边界，等用户明确确认后再往下走。\n\n## 五、技能地图\n\n| 技能 | 做什么 | 接在谁后面 |\n|---|---|---|\n| `repo-init` | 初始化或更新项目架构基线 `.sdd\u002Fsoftware_architecture.md` | 项目开始时 |\n| `sr-design` | 把原始需求收敛为 SR 级功能与技术设计 | 原始需求 |\n| `sr-design-gate` | SR 设计准入门禁 | `sr-design` |\n| `ar-clarify` | 为一个 AR 澄清范围，产出可独立设计的 AR 范围文档 | AR 拆分或用户直接给的 AR |\n| `module-boundary-design` | 确定承接模块与模块组 | `ar-clarify` |\n| `module-asis-analysis` | 模块现状（ASIS）取证分析 | 模块边界 |\n| `module-tobe-design` | 模块目标设计（TOBE） | ASIS |\n| `module-test-design` | 测试用例设计（严格 \u002F 轻量两种模式） | TOBE 或 `dev-design` |\n| `module-design-gate` | 模块设计准入门禁 | 模块设计与测试设计 |\n| `dev-design` | 轻量链路的单份设计 | 确认后的需求 |\n| `dev-design-gate` | 轻量链路的准入门禁 | `dev-design` 与轻量测试设计 |\n| `task-split` | 把已评审设计组织成有序的薄任务计划 | 门禁通过 |\n| `task-dev` | 一次实现一个任务：实现、测试、评审、重验、代码检查、交接 | 用户确认的任务计划 |\n| `code-check` | 代码规范与基本质量检查 | `task-dev` 的代码检查步骤，也可单独使用 |\n| `module-deep-research` | 长程的既有模块研究 | 需要深入理解存量模块时 |\n| `effective-document-writing`、`mermaid-diagram` | 写文档与画图 | 任意步骤 |\n\n问题池（question tracker）是各设计技能共用的提问记录：问题先入池、按轮次向用户提出、答案回填；中断后从池里恢复，不要另起炉灶。在工作流引擎的节点里，问题池由每次运行统一建好，只开放 `add_questions`、`answer_question`、`update_answer`、`get_status` 四个工具；各技能里列池、建池、重开、清空、归档的步骤在这种情况下跳过。\n","# AAW 工作方法\n\n本技能不驱动任何流程，也不依赖任何命令行工具。它说明在 AAW 的研发链路里怎样把事情做对；具体每一步怎么做，见各自的技能。流程由谁推进（工作流引擎、用户本人）都适用。\n\n## 一、需求先立住\n\n- **原始需求原样保存**。用户明确作为需求提供的文本保持原文：不总结、不改写、不做设计性加工；分布在多段时按原顺序完整保存。普通讨论、Agent 的解释和设计推导不得混入。\n- **保存后回显核对**。把保存下来的原文回显给用户（较长时回显开头若干行并注明总行数），请用户确认一致。用户指出不一致时，先修正原文、重新核对，再继续往下做。\n- **拿不准就问**。无法判断用户是否已经提供了原始需求时，先向用户收集，不得以空内容或臆造内容开始设计。\n- 原始需求是后续设计与门禁的权威对照；任何步骤都不得修改或覆盖它。\n\n## 二、按规模选链路\n\n| 链路 | 适用 | 主要成果物 |\n|---|---|---|\n| 完整链路（从 SR 开始） | 多人协作、复杂度高、需要分阶段留痕评审的需求 | SR 设计 → AR 拆分 → 每个 AR 的范围、模块边界、ASIS \u002F TOBE 详细设计、测试设计、模块门禁 → 任务计划与逐任务开发 |\n| 从单个 AR 开始 | 已有 SR 设计和架构基线，只推进其中一个 AR | AR 范围文档起，后同完整链路 |\n| 轻量链路 | 一个人能独立设计并实现、无需多角色交接的需求 | `dev-design.md`、`test-design.md`、轻量门禁报告、`tasks-overview.md` |\n\n判断标准是需求规模，不是赶时间。轻量链路把功能设计、模块边界与详细设计合成一份口径统一的文档，面向贯穿设计到开发的同一个人；如果团队要求这些阶段分开评审，就走完整链路。\n\n## 三、做每一步时\n\n- **以实际成果判断进度，不靠记忆**。上下文压缩、会话恢复或换人接手后，重新读取已有的文档、门禁报告和任务执行记录，从实际状态继续。\n- **必需输入缺失就停**。设计依据、门禁结论、架构基线等必需输入不存在或不可读时，说清缺什么、为什么需要，不要用推断或记忆补位。\n- **已有成果当基线**。当前步骤的输出文件已存在时，仍按当前要求完整执行：先读取并评估，复用仍有效的信息和已确认的答案，只问当前确实无法确定的问题，可局部修改或整体重写，写回原位置。\n- **不编造**。代码能回答的问题先查代码，并在提问时说明查过什么；代码证不出、需要拍板的事交给用户决定，不默认采纳自己的推荐。\n- **文档放在约定位置**。调用方指定了位置就用它；没有指定时用各技能里写的默认布局，同一需求的文档放在一起，并告诉用户放在哪里。\n- **项目架构基线**是 `.sdd\u002Fsoftware_architecture.md`（由 `repo-init` 生成和维护）。模块边界以它为准，缺失时按各技能的降级口径处理并明确记录。\n\n## 四、门禁与返工\n\n- **门禁是准入，不是直通**。每一轮门禁都要生成或更新门禁报告，通过、不通过、阻塞都一样；不允许只在会话里口头给结论。\n- **不通过就原地修上游**。结论为不通过或阻塞时，不要推进下游；默认修正对应的上游成果物后重新执行门禁：SR 设计门禁修 `SR-design.md`，模块设计门禁修 ASIS \u002F TOBE \u002F 测试设计，轻量门禁修 `dev-design.md` 或 `test-design.md`。\n- **复检要全量**。保留上一轮的问题编号，逐项给出关闭、转非阻断或仍阻断的状态；复检仍做全量检查，不只看历史问题。\n- **不擅自回退**。只有用户明确要求重走上游步骤时才返工。返工前先讲清：退回到哪一步、哪些下游成果会失效、涉及哪些文件；再请用户选择「保留已有成果，在其基础上返工」还是「丢弃这些成果，从有效的上游输入重做」。\n- **关键边界要用户点头**。进入实现之前（任务计划确认）、正式基线确认之类的边界，等用户明确确认后再往下走。\n\n## 五、技能地图\n\n| 技能 | 做什么 | 接在谁后面 |\n|---|---|---|\n| `repo-init` | 初始化或更新项目架构基线 `.sdd\u002Fsoftware_architecture.md` | 项目开始时 |\n| `sr-design` | 把原始需求收敛为 SR 级功能与技术设计 | 原始需求 |\n| `sr-design-gate` | SR 设计准入门禁 | `sr-design` |\n| `ar-clarify` | 为一个 AR 澄清范围，产出可独立设计的 AR 范围文档 | AR 拆分或用户直接给的 AR |\n| `module-boundary-design` | 确定承接模块与模块组 | `ar-clarify` |\n| `module-asis-analysis` | 模块现状（ASIS）取证分析 | 模块边界 |\n| `module-tobe-design` | 模块目标设计（TOBE） | ASIS |\n| `module-test-design` | 测试用例设计（严格 \u002F 轻量两种模式） | TOBE 或 `dev-design` |\n| `module-design-gate` | 模块设计准入门禁 | 模块设计与测试设计 |\n| `dev-design` | 轻量链路的单份设计 | 确认后的需求 |\n| `dev-design-gate` | 轻量链路的准入门禁 | `dev-design` 与轻量测试设计 |\n| `task-split` | 把已评审设计组织成有序的薄任务计划 | 门禁通过 |\n| `task-dev` | 一次实现一个任务：实现、测试、评审、重验、代码检查、交接 | 用户确认的任务计划 |\n| `code-check` | 代码规范与基本质量检查 | `task-dev` 的代码检查步骤，也可单独使用 |\n| `module-deep-research` | 长程的既有模块研究 | 需要深入理解存量模块时 |\n| `effective-document-writing`、`mermaid-diagram` | 写文档与画图 | 任意步骤 |\n\n问题池（question tracker）是各设计技能共用的提问记录：问题先入池、按轮次向用户提出、答案回填；中断后从池里恢复，不要另起炉灶。在工作流引擎的节点里，问题池由每次运行统一建好，只开放 `add_questions`、`answer_question`、`update_answer`、`get_status` 四个工具；各技能里列池、建池、重开、清空、归档的步骤在这种情况下跳过。\n",{"name":5,"version":24,"description":7},"3.0.0","main","1eebb43c5a2fb76f30bc4287379d9c542171e520","skills-v2\u002Faaw-practices",6,"https:\u002F\u002Fgithub.com\u002Fpi-ixel\u002FAwesome-Agent-Workflow","https:\u002F\u002Fgithub.com\u002Fpi-ixel","2026-11-15 02:31:13",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add pi-ixel\u002FAwesome-Agent-Workflow --skill aaw-practices",{"tool":38,"command":39},"bunx","bunx skills add pi-ixel\u002FAwesome-Agent-Workflow --skill aaw-practices",{"tool":41,"command":42},"pnpm","pnpm dlx skills add pi-ixel\u002FAwesome-Agent-Workflow --skill aaw-practices","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fpi-ixel\u002FAwesome-Agent-Workflow\u002Fblob\u002Fmain\u002Fskills-v2\u002Faaw-practices\u002FSKILL.md",true,[],[47,54,61,68,75,82],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":19},"01M7DYNMAA7RGAS2TP3SK6T276","task-split","基于已确认的设计与测试规格，生成单文件薄任务计划 tasks-overview.md；任务只保留目标、范围、权威设计\u002F测试引用、依赖和状态，不复制或改写设计正文。Use when the user asks for 任务拆分、开发任务规划、有序任务计划、task split，或希望把已评审设计组织为可串行调度的 T1\u002FT2 任务。支持两种模式：严格模式以详细设计文档、测试用例设计文档和通过的模块设计门禁结果为输入；轻量模式以 dev-design.md 与 test-design.md 两份文档为输入，由调用方说明。","https:\u002F\u002Fgithub.com\u002Fpi-ixel\u002FAwesome-Agent-Workflow\u002Fblob\u002Fmain\u002Fskills-v2\u002Ftask-split\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M7DYNF6714X8RTXSVX84DD11","task-dev","实现一个明确的 T[N] 任务并把它做完：按已评审设计实现与测试，两路只读语义 Review，修复与重验，代码检查，写交接记录与候选提交信息。Use when the user asks to 实现当前 Task、执行 task-dev、继续或恢复 T1\u002FT2 开发。支持严格模式（以模块详细设计与测试用例设计为事实来源）与轻量模式（以 dev-design.md 与 test-design.md 为事实来源）。每次只处理一个 Task，不执行 git add 或 git commit，也不自行开始下一个 Task。","https:\u002F\u002Fgithub.com\u002Fpi-ixel\u002FAwesome-Agent-Workflow\u002Fblob\u002Fmain\u002Fskills-v2\u002Ftask-dev\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M7DYNB2NBRHHD5RCN01EF134","sr-design","帮助开发者创建功能\u002F模块设计文档。用户描述系统整体要做什么，你负责研究代码仓库， 确定如何调整内部结构来实现目标，并通过逐题澄清消除所有不确定细节。 文档聚焦软件架构、功能设计与模块设计，而非代码实现细节。","https:\u002F\u002Fgithub.com\u002Fpi-ixel\u002FAwesome-Agent-Workflow\u002Fblob\u002Fmain\u002Fskills-v2\u002Fsr-design\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M7DYN8W13GXXDVQ3W1980JZA","sr-design-gate","对 SR-design.md 进行设计质量门禁，检查需求范围、架构边界、接口与数据契约、验收闭环、风险处置、图表变更表达以及文档跨章节一致性。用于 SR 设计完成后、进入 ar-split 前判断 SR 级设计是否完整，并输出通过、不通过或阻塞结论。","https:\u002F\u002Fgithub.com\u002Fpi-ixel\u002FAwesome-Agent-Workflow\u002Fblob\u002Fmain\u002Fskills-v2\u002Fsr-design-gate\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M7DYN638WCYRAMY0G1JVJN80","repo-init","Use when the user asks for 软件实现设计\u002Fsoftware_architect\u002F初始化代码仓\u002Fsdd\u002F初始化\u002Finit\u002F更新代码仓软件架构\u002F更新代码仓软件实现设计.","https:\u002F\u002Fgithub.com\u002Fpi-ixel\u002FAwesome-Agent-Workflow\u002Fblob\u002Fmain\u002Fskills-v2\u002Frepo-init\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M7DYN1S15DBT8Y205DMZRP2F","module-tobe-design","基于调用方指定的正式《模块详细设计说明书.md》及模块目录下的 `.context\u002F详细设计上下文.md`，设计模块内与本次需求相关的 TOBE 详细方案。TOBE 是唯一可以编辑正式说明书的阶段，必须按正式大纲写入需求背景、外部依赖、整体方案、模块详细方案、对外接口、数据库\u002F表设计、受影响模块与交互、关键契约清单和附录\u002F三方件约束。TOBE 只负责目标设计和可测试性输入，不生成测试用例，不拆分 AICoding 任务；测试用例设计交由 `$module-test-design`，编码任务拆分交由外部 AICoding 流程。详细设计上下文记录 ASIS 证据、TOBE 推导和过程，不得替代正式说明书。不得脱离 ASIS 证据凭空设计；ASIS context 缺失或不足时必须回补 ASIS 或标记阻塞。","https:\u002F\u002Fgithub.com\u002Fpi-ixel\u002FAwesome-Agent-Workflow\u002Fblob\u002Fmain\u002Fskills-v2\u002Fmodule-tobe-design\u002FSKILL.md",[],[]]