← 返回 Skill 列表
extension
分类: 开发与工程API Key 暂未确认

愚公移屎山

hs-dev-skill 的核心理念是:AI 驱动文档,文档驱动代码。 AI 协助把想法整理为需求、设计、原型、契约与任务;开发者确认关键内容后,模型依据这些文档实现代码,并把变更与验证结果写回记录。文档随开发持续更新,成为下一步工作的依据。

person作者: HardStone4ModelhubModelScope

产品开发主路由 Skill

版本:v4.0.0.0

Agent 驱动文档,已验收的文档驱动代码。本入口只负责分派与共享边界;具体过程和专业规则由真实的子 Skill 执行。完整包含 10 个过程 Skill + 6 个功能 Skill,详规和工具保持单份共享。

先判路由,再加载

  1. 识别当前任务的 intent、change_size=S/M/L、work_mode=DESIGN/IMPLEMENT/READONLY、实际阶段及触达领域。沿用已有明确确认;模糊业务预期交 discovery,不靠工程假设补齐。
  2. 只读分析走 exploration;“继续”走 continuity 先恢复;变更和验收事件优先进入对应子过程。FIX/REFACTOR/REVERSE 不套 BUILD 全链。
  3. 从下表读取 一个过程子 Skill,再按任务触达面读取功能子 Skill;未触达领域不加载。每次只推进当前切片,不能开局通读所有子 Skill。
  4. 按各入口执行流程读取指导文档、建立/更新计划、执行、提交证据并形成工作文档;用检索/切片加载子 Skill 指定详规和项目输入,遵循装载规则。输入、输出与返回约定见子 Skill 协议。
  5. 子 Skill 返回当前产物、证据、验收状态及下一动作后,主路由继续分派;不得将调用成功解释成阶段完成。

路由唯一机器清单:resources/skill_routes.json。工具不猜阶段、不执行任务、不代签:

# 路径相对安装包;在工程中使用时换成安装包脚本的绝对路径
python3 scripts/skill_router.py check
python3 scripts/skill_router.py list
python3 scripts/skill_router.py route --intent BUILD --phase 3 --domains backend
python3 scripts/skill_router.py route --intent FIX --domains frontend testing
python3 scripts/skill_router.py route --intent RESUME

纵向:过程分派

| 当前目标 | 过程子 Skill | 交付边界 | |---|---|---| | BUILD 阶段 0:需求与产品对齐 | hs-dev-discovery | 真实场景、范围、预期、产品冻结 | | BUILD 阶段 1/2/3:选型/架构/详设 | hs-dev-design | 仅当前阶段设计与验收证据 | | BUILD 阶段 4:拆任务与装配 | hs-dev-planning | 需求映射、任务、有效 Pack | | BUILD 阶段 5:执行切片 | hs-dev-implementation | 代码、契约、测试及切片演练 | | BUILD 阶段 6 / 任意阶段验收 | hs-dev-acceptance | 当前版本的证据与开发者验收 | | FIX:修复实际缺陷 | hs-dev-debugging | 复现、根因、修复与回归 | | REFACTOR:保持行为的结构调整 | hs-dev-refactoring | 保护网、结构改善、等价证据 | | REVERSE:存量项目纳管 | hs-dev-reverse | 可证实的现状契约与索引 | | EXPLORE:只读理解 | hs-dev-exploration | 解答与证据,免任务/PRD/Commit | | RESUME / 需求变更 / 回退 | hs-dev-continuity | 恢复阶段、影响分析、有效基线 |

BUILD 的 L 路径为 0→1→2→3→4→5→6;M 仅补触达面,S 只做已清晰的局部变更。分级细则见 right_sizing,不得为走流程制造空文档。

横向:功能分派

| 触达面 | 功能子 Skill | 负责内容 | |---|---|---| | 产品目标、功能、业务流程 | hs-dev-product | PRD、规则、场景、MVP、原型验收 | | 选型、系统边界、模块协作 | hs-dev-architecture | 范式、ADR、架构、模式权衡 | | 界面、交互、前端结构与代码 | hs-dev-frontend | DESIGN.md、原型、组件、a11y、运行体验 | | 后端、DB、API、方法契约 | hs-dev-backend | 数据约束、接口、Adapter、方法与迁移 | | 测试策略与执行证据 | hs-dev-testing | TDD、契约/集成/回归、DoD 对账 | | 索引、版本、词典与工程治理 | hs-dev-governance | 共享工程设施及按开关启用的治理 |

例如“支付接口超时”是 debugging + backend/testing;“设计采购工作台”是 discovery + product/frontend;“继续支付任务”先 continuity,恢复后再确定过程。过程 Skill 管推进,功能 Skill 管专业结果,均不能自行扩大授权。

所有子 Skill 共同遵守

  • 范围与确认:保留开发者目标、范围和已确认决定。Agent 推导与真实确认分开;新增业务的 DB 设计、计费/权限/归属及关键契约按既有决策规则处理。
  • 验收驱动流转:每个实际阶段按 阶段验收协议 的标准、证据和有效确认流转;模型自检只是候选结论。源语义变化使相关验收和派生 Pack 失效。
  • 测试与完成:实现必有适用验证,测试全绿、静态检查零告警、严格一致性检查及需求/DoD 回收按 testing 和 quality_gates 执行;不得假代码、伪造证据或静默砍功能。
  • 只读边界:EXPLORE 不建任务/PRD、不改状态、不初始化、不提交;此约束传递到所有功能 Skill。
  • 持续与恢复:有独立可推进工作就继续;阶段待验收、必要决策或外部条件阻断时记录交接。续做沿用 plan/change,不重开需求。
  • 共享单源:详规、模板、脚本维持既有路径;功能性细则只在对应子 Skill 按需加载。规范来源区分公开阅读、标准范围及项目自定规则。
  • 操作边界:代码/设计修改前按既有 checkpoint 约定保留回退依据;默认本地 Commit,只有明确授权才 push/发布。不因选中治理 Skill 自动开启重型设施。

定位共享资源

主包根与目标工程根分开,详见 运行协议。本包的 scripts/skill_ref_index.py search 检索子入口/详规;doc_index_db.py --root <工程根> 检索业务文档;工具总览见 README。子 Skill 是本包组成部分,安装需保留整个目录树。