| name | mica-common-tasks |
| description | 当需要面向任务的 MICA 工作流时使用,包括使用、开发、调试、测试、学习、评审、服务追踪和配置到代码解释。 |
MICA 常见任务
概览
在 MICA 基础背景模型已经明确后,如果下一步需要根据用户的具体意图选择工作流,使用这个 skill。
这个 skill 有意保持任务工作流导向。它把使用、开发、调试、测试、学习和评审请求导入可复用的 playbook;更深入的技术解释仍然放在同级 domain skill 中。
如果请求已经明确落在 micrun/ 子项目,而不是 MICA 主工作流,应在 mica-overview 背景模型已经建立后改用 ../micrun-overview/SKILL.md。
使用场景
- 需要回答具体用户任务,而不是只解释架构
- 需要指导 MICA 命令、配置、TTY、UMT、RPC 或 GDB 的使用
- 需要规划新 service、新 RTOS 对接、新 pedestal 或硬件平台支持
- 需要调试生命周期、service readiness、通信、性能或跨层故障
- 需要在适配、bugfix、service 开发或评审后验证基础 MICA 功能
- 需要通过学习路径解释 MICA 概念
- 需要按 MICA 架构和行为规则评审 PR 或 patch
不适用于:
- 任务选择前的基础架构导入;使用
mica-overview
- 没有任务语境的单层深度解释;直接使用对应 subsystem skill
- 明确属于
micrun/ 子项目的问题;在 mica-overview 背景模型建立后使用 ../micrun-overview/SKILL.md
相关参考
从这里开始:
references/usage-workflow/usage-overview.md
references/development-workflow/development-overview.md
references/debugging-workflow/debugging-overview.md
references/testing-workflow/testing-overview.md
references/learning-workflow/learning-overview.md
references/review-workflow/review-overview.md
阅读指导
- 如果请求明确涉及
micrun/ 或 MicRun 子项目,在 mica-overview 背景模型建立后切换到 ../micrun-overview/SKILL.md
- 使用类问题从
references/usage-workflow/usage-overview.md 开始
- 开发类问题从
references/development-workflow/development-overview.md 开始
- 故障分析或性能问题从
references/debugging-workflow/debugging-overview.md 开始
- 验证和回归问题从
references/testing-workflow/testing-overview.md 开始
- 概念学习问题从
references/learning-workflow/learning-overview.md 开始
- PR 或 patch 评审从
references/review-workflow/review-overview.md 开始
- 当请求精确匹配 start 失败、service 开发、层级分类或配置到代码解释时,使用各目录内的聚焦 workflow 文件
提交与 PR 规则
- 涉及 MICA 代码或文档提交时,commit 必须包含
Signed-off-by;优先使用 git commit -s,amend 时使用 git commit --amend -s。
- commit message 不能只有标题;正文应说明背景、变更内容、验证结果或影响范围,至少覆盖与该提交相关的关键信息。
- 创建或更新 AtomGit/GitCode PR 时,PR 标题和正文必须使用中文,除非 maintainer 明确要求英文。
- PR 正文应至少包含背景、变更内容、影响范围和验证结果;验证结果应写清环境、关键命令或场景、通过标准。
常见误区
-
把这些任务参考文档当成 subsystem 文档的替代品。
- 它们是入口;归属明确后,应继续进入对应 subsystem skill。
-
在问题尚未分类前直接进入深层 subsystem 文档。
- 归属不清时,任务 playbook 通常能更快进入正确层级。