JS Mastery 工程工作流技能包
把一个模糊想法变成已验证、已交付、有文档的代码，为任何 AI 编码代理提供分阶段的技能流水线。
README 描述工件全部落在用户仓库内（docs/、AGENTS.md），安装经 npx skills 官方通道，零依赖检查器降低供应链面；但具体 SKILL.md 未在证据中呈现，最小权限、用户确认、外部副作用（如 /develop 运行迁移）、回滚与敏感数据处理均无文件可证，仅得 1 分；归属为未验证发布者，README 有作者署名但无 provenance 支持。
CI 在 push/PR 上运行零依赖可移植性检查（scripts/check-portability.mjs），token 预算分析存在，自我一致性好；但失败信息、错误路径在证据中未见具体描述，/check 的验证能力无源码佐证。
README 明确覆盖 greenfield/brownfield/monorepo/单点变更四种场景及 Claude Code、Cursor、Codex、Gemini CLI 等多客户端，且 docs/ 与 .workflow/ 的环境适配规则清晰，是本仓库最强项；能力边界（gate 非绝对保证）有诚实说明，但按技能的触发精度只能靠 README 推断。
信息架构（技能表、工件-路径-归属表、流程图）非常完整，MIT LICENSE 全文在案，hardening 移除被明示为已知限制；但无 CHANGELOG/版本历史文件，安装说明依赖外部 npx skills 文档且未提及升级/卸载，FAQ 与维护责任人、更新路径缺失。
文件态状态设计、/clear 建议、workflow depth 分层都指向真实的成本收益考量；工件路径可预期，输出可用性中等偏上，但实际效果（如 /check verify 是否真能验证）无执行证据。
README 的主张（gate 分层、portability check）可通过仓库内脚本/CI 部分追溯，但本次证据未含 SKILL.md 与脚本内容，多数声明无法交叉印证；声明与推断区分尚可，但跨源印证弱。
- 发布者未经企业注册表验证，身份按未知处理，不因品牌加分。
- SKILL.md 实际指令未在本次证据中呈现，权限、副作用与确认行为无法静态核实，请在隔离环境先行试用。
- /develop 会运行数据库迁移，需在受控分支与备份下使用。
- 无 CHANGELOG 与版本历史，升级时逐项 diff 技能文件。
- 安装依赖外部 npx skills 工具链，注意该上游自身的供应链安全。
这个 Agent 能做什么，适合哪些场景？
这是一套遵循 Agent Skills 开放格式的技能集合（仓库 jsmastery-pro/skills，MIT 许可），覆盖 JS Mastery 工作流背后的完整开发流程。它包含 scope、audit、architect、develop、check、test、document、sync、debug 九个技能，每个技能对应一个阶段，可按需、按任意顺序运行。核心设计是“状态活在文件里”：范围计划、规格、AGENTS.md 上下文文件和测试都落在仓库目录（如 docs/scope/、docs/specs/），因此工作可以跨会话延续，也便于整个团队共享。通过 npx skills 安装到 Claude Code 的 .claude/skills 或通用的 .agents/skills 目录，适用于任何 Agent Skills 客户端。每个技能的指令在各自的 SKILL.md 中，agents/openai.yaml 只是接口元数据，不含逻辑。
工作流为：想法 → /scope → /audit → /architect → /develop → /check verify → /test → /check review → /document → /sync。/scope 把产品想法变成持续维护的粗粒度范围文件（docs/scope/）；/audit 生成 AGENTS.md 上下文文件供其他技能读取；/architect 将承重决策写成构建规格（docs/specs/）；/develop 依据规格构建前后端功能，若缺少决策则门控到 /architect；/check verify 运行真实应用验证功能，/check review 在另一个模型上做资深代码评审；/test 为改动编写测试套件；/debug 做根因排查并交给 /test 写回归测试；/document 从真实 diff 生成 PR 文案、CHANGELOG.md、发布说明或复盘；/sync 在合并后让 AGENTS.md、范围和规格状态与仓库保持一致。安装命令：npx skills@latest add jsmastery-pro/skills -a claude-code（Claude Code）或 npx skills@latest add jsmastery-pro/skills（通用 .agents/skills，供 Codex 等读取）。安装后重启 Claude Code，并把技能目录提交到仓库与团队共享。
- 从零开始新产品的开发者：先用 /scope 规划想法，再 /architect 定技术栈，脚手架完成后 /audit 生成 AGENTS.md，然后进入功能循环。
- 接手已有代码库的团队：先运行 /audit 让每个技能了解项目的栈、命令与约定，再用 /scope 规划下一片增量。
- 需要修 Bug 的工程师：直接运行 /debug 做根因排查，产出的回归测试交给 /test。
- 提交 PR 前的把关者：用 /check verify 在真实应用里验证功能，再用 /check review 让另一个模型做资深评审。
- 维护 monorepo 的团队：一切以目标工作区为范围，每个工作区有自己的 AGENTS.md、范围和命令。
- 需要写发布材料的开发者：/document 从真实 diff 生成 PR 描述、变更日志或事故复盘。
这个 Agent 有哪些优点和局限？
- 状态存于文件（范围、规格、AGENTS.md、测试），工作可跨会话延续并供整个团队共享，而非依赖单个聊天会话。
- 每个技能独立、可按需按序运行：一个 Bug 走 /debug，小改动只需 /develop 加 /check verify，不必走完整流程。
- 带门控的规格驱动设计：/develop 在缺少承重决策时路由到 /architect，强行覆盖也会把假设记录为 Assumed 规格并持续标记，直到 /architect 批准。
- 模型无关：任何 Agent Skills 客户端（Claude Code、Cursor、Codex、Gemini CLI 等）都能读取 SKILL.md，/check review 还刻意使用与写代码不同的模型做交叉评审。
- 并非独立运行的程序，依赖宿主 AI 编码代理（如 Claude Code 或 Codex）来实际执行技能；没有这些客户端就无法使用。
- 需要采纳一套新的文件约定（docs/scope/、docs/specs/、AGENTS.md 等）并随代码提交，对现有仓库结构和团队习惯有迁移成本。
- Hardening（系统级失效模式分析）暂时被移除，需等待以系统设计专项形式回归。
- 工作流的门控是分层的提示约束而非绝对保证，README 明确承认没有提示能做到绝对可靠；行为正确性还要靠 /check verify 和 /test 兜底。
- README 没有提供性能基准、用户数量或长期维护证据，采用前需自行评估。
如何安装或部署这个 Agent？
需要 Node.js/npm 环境和任意 Agent Skills 客户端（Claude Code、Cursor、Codex、Gemini CLI 等）。安装：# Claude Code（安装到 .claude/skills，然后重启 Claude Code）
npx skills@latest add jsmastery-pro/skills -a claude-code# 通用 .agents/skills，供 Codex 及其他代理读取
npx skills@latest add jsmastery-pro/skills安装后将技能目录提交到仓库即可与团队共享。无需额外凭据。
如何使用这个 Agent？
在 AI 编码代理的会话中以斜杠命令调用：新项目按 /scope → /architect → 脚手架 → /audit → 功能循环的顺序；老项目先 /audit 再 /scope；单个小改动只需 /develop 加 /check verify；出 Bug 时随时 /debug；任何时候裸跑 /scope 可查看当前进度。在 /scope 末尾为项目选择工作流深度：Prototype（仅 /develop 自检）、Alpha（加 /check verify）、Beta（加 /test）、GA（再加新模型 /check review 和 /document），可随时按功能覆盖。工作流建议在技能交接时执行 /clear，让新会话从磁盘文件重新读取状态。若 docs/ 是已发布的文档站点，相关文件会移到 .workflow/ 目录。