Community编程与开发github.com

tj-agents/personal

个人项目强制采用的当前解决方案与适度工程规则。

personal 是什么?

该技能为明确采用`personal@tj-agents`的个人项目定义了一套强制性规则,确保仅当项目作者(Tommy)主动声明其个人范围时生效,而非通过主目录或雇主信息自动关联。其核心原则包括:始终维护唯一受支持的解决方案,在替换功能时彻底清除旧名称、别名、回退实现及兼容性代码,并协调所有已知调用者、配置和运行时入口点完成迁移,避免为假设的外部用户保留过时行为。此外,要求在多平台(如Windows和Linux)上实际验证入口点,而非仅依赖源码编辑或单元测试,例如在替换`old-launch`为`launch`后需在全新会话中实际执行以确认迁移完成。同时,禁止独立添加向后兼容性例外,除非有明确用户需求并经审慎决策;主张以最小实现解决具体问题,按比例验证行为与有意义的失败路径,反对过度抽象或冗余测试。该技能主要用于需要严格维护个人项目整洁性与专注力的开发场景,支持通过SKILL.md文档生成原生指令块并检测漂移。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tj-agents/personal/tree/HEAD/.agents/personal/policy/current-solution

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

个人项目

这些规则适用于明确采用 personal@tj-agents 的项目。采用行为记录了项目的个人范围;主目录、作者姓名或雇主关联本身并不构成个人范围。除非 Tommy 明确更改此范围,否则雇主项目仍属于此配置文件之外。

维护唯一当前受支持的解决方案。在替换行为时,移除被取代的名称、别名、回退实现、适配器、配置格式及兼容性分支。在同一切换点协调并迁移所有已知调用者、项目声明、已安装注册项、生成产物及实时运行时入口点。不得为假设的外部用户保留过时行为;与实际的合作开发者协调升级。

在包括 Windows 和 Linux 启动路径(若支持)在内的每个受支持平台上,验证用户实际使用的入口点。仅靠源码编辑、成功生成、通过的单元测试及版本命令,不足以证明迁移已完成。检查已安装绑定及全新运行时行为。将任何未经验证的入口点记录为不完整,并注明其解析器及可观测的验收条件。

例如,将 old-launch 替换为 launch 意味着迁移已注册的 shell 命令、项目配置及实际调用者,删除旧入口点,然后在每个受支持操作系统的新会话中调用 launch。仅运行 launch --version 会使切换点未经验证。

将 old-launch 替换为 launch:
1. 迁移已注册的 shell 命令、配置及实际调用者。
2. 删除旧入口点并重新生成已安装的设置。
3. 从受支持的新 Windows/Linux 会话中调用 launch,并检查其实际行为。
结果:仅运行 launch --version 会导致此迁移不完整。

不得独立添加向后兼容性例外。将明确的相反用户需求作为审慎策略决策提出,识别受影响的受支持行为,并在实施前协调此配置文件的范围。切勿在回退或适配器中隐藏例外。

以最小适合实现解决已证明的问题。仅为具体当前需求添加抽象、依赖项、配置开关、重复路径或进程机制。优先使用项目已选择的能力。按比例验证行为及有意义的失败路径;不得添加仅重复实现或没有具体收益的检查列表式测试。

此策略在此仅编写一次。个人采用会从此文档体生成标记的原生命令块,并检查其是否发生漂移。单独的选定插件或 always 层级不能证明加载成功。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能