一键在 Manus 中运行任何 Skill

code-quality-review

星标1

分支0

更新时间2026年4月2日 18:35

Review and improve Python code quality in SoulMap AI so typing, helper usage, exception handling, and repo tooling conventions stay consistent.

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

tuanductran

tuanductran/soulmap-ai

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

Code quality review

Use this skill when reviewing or improving Python implementation quality in src/, compatibility wrappers, tests/, or scripts/.

Do not use this skill for

product doctrine or response-safety review, use ai-prompt-engineering-safety-review
eval suite design, use eval-suite-maintainer
packaging and release checks, use packaging-maintainer

Mission

Keep Python changes clear, typed, maintainable, and consistent with the repo's existing tooling contract.

Sources to check first

pyproject.toml
../rules/python-tooling.md
../rules/source-character-safety.md
docs/engineering/DEV.md
the target Python files and nearby tests

What to look for

stale or duplicated helper logic
weak typing or type drift against repo conventions
broad exception handling or hidden failure paths
dead branches, unused fields, or wrappers that add no value
local code that should use shared helpers in src/soulmap/runtime/io/cli_payload.py or src/soulmap/runtime/io/text_normalization.py

Workflow

Read the target Python files and the closest tests first.
Compare the implementation with pyproject.toml and ../rules/python-tooling.md.
Identify concrete quality issues that affect clarity, correctness, or maintenance.
Make the smallest correct change that improves the code without widening scope.
Update tests when the observable contract changes.
Run the repo checks needed for the touched files.

Expected output

Findings

List the concrete code-quality issues first.

Fixes

Summarize the changes that improved type safety, helper usage, or readability.

Validation

State which checks were run and whether they passed.

Definition of done

The updated code should be:

simpler or clearer than before
aligned with repo tooling rules
free of obvious duplicated logic
covered by the right tests for the changed behavior

同仓库更多 Skills

同仓库

soulmap-ai

tuanductran/soulmap-ai

SoulMap, a reflective companion that helps people stop abandoning themselves. Includes a central coordination layer, a clear response pipeline, routing guidance, depth calibration, epistemic guardrails, safety guardrails, voice system, brand doctrine, and reusable templates. Mirror, not guide.

2026-07-181

detector-engineer

tuanductran/soulmap-ai

Build and maintain Python detector modules that identify framework selection signals in conversation history.

2026-07-171

frameworks

tuanductran/soulmap-ai

SoulMap reflective response frameworks covering emotional de-escalation, grief, existential reflection, inner parts, life direction, shadow work, synthesis, and relational inquiry. Relevant for tasks that require choosing or applying the core reflective method for a user conversation.

2026-07-161

safety

tuanductran/soulmap-ai

SoulMap safety and boundary rules covering crisis handling, dependency prevention, trauma-informed language, prompt injection defense, and scope control. Relevant for requests that involve harm, escalation, refusal, redirection, or questions about what SoulMap must not do.

2026-07-161

spiritual

tuanductran/soulmap-ai

SoulMap symbolic spiritual materials covering brand-safe numerology, chakra policy, healing metaphors, and archetypal language. Relevant for tasks that involve spiritual framing within SoulMap's grounded, non-predictive, non-grandiose boundaries.

2026-07-161

brand

tuanductran/soulmap-ai

SoulMap brand doctrine, positioning, message hierarchy, surface-specific rules, and strategic direction. Relevant for tasks that concern what SoulMap is, what it is not, how it sounds in public, or how brand language stays aligned across product surfaces.

2026-07-051

name	code-quality-review
description	Review and improve Python code quality in SoulMap AI so typing, helper usage, exception handling, and repo tooling conventions stay consistent.

Code quality review

Use this skill when reviewing or improving Python implementation quality in src/, compatibility wrappers, tests/, or scripts/.

Do not use this skill for

product doctrine or response-safety review, use ai-prompt-engineering-safety-review
eval suite design, use eval-suite-maintainer
packaging and release checks, use packaging-maintainer

Mission

Keep Python changes clear, typed, maintainable, and consistent with the repo's existing tooling contract.

Sources to check first

pyproject.toml
../rules/python-tooling.md
../rules/source-character-safety.md
docs/engineering/DEV.md
the target Python files and nearby tests

What to look for

stale or duplicated helper logic
weak typing or type drift against repo conventions
broad exception handling or hidden failure paths
dead branches, unused fields, or wrappers that add no value
local code that should use shared helpers in src/soulmap/runtime/io/cli_payload.py or src/soulmap/runtime/io/text_normalization.py

Workflow

Read the target Python files and the closest tests first.
Compare the implementation with pyproject.toml and ../rules/python-tooling.md.
Identify concrete quality issues that affect clarity, correctness, or maintenance.
Make the smallest correct change that improves the code without widening scope.
Update tests when the observable contract changes.
Run the repo checks needed for the touched files.

Expected output

Findings

List the concrete code-quality issues first.

Fixes

Summarize the changes that improved type safety, helper usage, or readability.

Validation

State which checks were run and whether they passed.

Definition of done

The updated code should be:

simpler or clearer than before
aligned with repo tooling rules
free of obvious duplicated logic
covered by the right tests for the changed behavior